/api/orgs/{org_id}/provider/requestsFile a change request
add_models applies at once when two gates pass: the manifest review against the live catalog, then a real streamed completion against your endpoint for every wire id (with the stored house key, or smoke_api_key, which authenticates the probe only and is never stored). Either failure answers 400 and lists nothing; new lanes land unlisted, so list each one afterwards. update_prices and update_model also apply at once (update_model at most once per 24 hours, else 429); update_limits lands pending for platform review. Org admin session or the org's own key.
認証: AuthorizationヘッダーにBearer形式のAPIキー
パスパラメータ
org_idstring必須Your organization id (uuid).
GET /api/whoamireturns it.
リクエストボディ
kindenum必須payloadobject必須The shape
kindselects.いずれか
add_models
modelsarray<any>必須Wire ids must be unique, and no two entries may propose the same new model slug.
models
wire_idstring必須The model id your endpoint accepts in
model.bindingobject必須Bind to a catalog model (
existing) or propose a new one (new).いずれか
object
kindstring必須slugstring必須An existing catalog model slug.
object
kindstring必須modelobject必須model
slugstring必須display_namestring必須descriptionstring | nullcontext_windowinteger | nullmax_output_tokensinteger | nullinput_modalitiesarray<enum>huggingface_urlstring | nullExactly https://huggingface.co//.
release_urlstring | nullhttps URL with a real dotted host.
pricesobject必須Per-million-token rates in integer nano-USD (1 USD = 1,000,000,000 nano-USD). Each rate is at most 1,000,000,000,000 ($1,000 per million tokens).
prices
input_nano_usd_per_millioninteger必須output_nano_usd_per_millioninteger必須cached_input_nano_usd_per_millioninteger | nullCached input rate; null means no cached rate.
reasoning_nano_usd_per_millioninteger | nulleffective_atstring | nullOptional timestamp with a timezone offset.
capabilitiesobjectDeclared capability booleans. Keys must come from the gateway's capability vocabulary (for example
supports_streaming,supports_parallel_tool_calls,supports_structured_text,supports_image_input,reports_cached_input_tokens,reports_reasoning_tokens); unknown keys are refused. A lane needssupports_streaming: trueto be listed.context_windowinteger | nullregionstring | nulldeprecationobject | nulldeprecation
eol_atstring必須replacement_slugstring | null
data_policyobject | nullPer-model data handling. Required on every model in an application.
いずれか
object
retains_promptsboolean必須retention_daysinteger | nullDays prompts are kept.
trains_on_databoolean必須zero_data_retentionboolean必須policy_urlstring | nullPublic https URL of the policy.
dispatchobject | nullいずれか
object
scale_up_secondsinteger | nullWarm-up time before saturation counts against the lane.
overflow_policyenumWhat happens once saturated.
max_concurrencyinteger | nullDeclared cap on in-flight requests for this model.
rpminteger | nullRequests per minute dispatch limit for the new lane; omit for the default.
tpminteger | nullTokens per minute dispatch limit for the new lane; omit for the default.
service_tier_pricing_enabledboolean | nullservice_tier_ratesobject | nullいずれか
object
flexobject | nullいずれか
object
inputinteger | nullcached_inputinteger | nullcache_creation_inputinteger | nullcache_creation_1h_inputinteger | nulloutputinteger | nullreasoninginteger | nulllong_contextobject | nulllong_context
input_threshold_tokensinteger必須inputinteger | nullcached_inputinteger | nullcache_creation_inputinteger | nullcache_creation_1h_inputinteger | nulloutputinteger | nullreasoninginteger | null
priorityobject | nullいずれか
object
inputinteger | nullcached_inputinteger | nullcache_creation_inputinteger | nullcache_creation_1h_inputinteger | nulloutputinteger | nullreasoninginteger | nulllong_contextobject | nulllong_context
input_threshold_tokensinteger必須inputinteger | nullcached_inputinteger | nullcache_creation_inputinteger | nullcache_creation_1h_inputinteger | nulloutputinteger | nullreasoninginteger | null
update_prices
changesarray<object>必須changes
wire_idstring必須A wire id one of your live lanes serves.
pricesobject必須Per-million-token rates in integer nano-USD (1 USD = 1,000,000,000 nano-USD). Each rate is at most 1,000,000,000,000 ($1,000 per million tokens).
prices
input_nano_usd_per_millioninteger必須output_nano_usd_per_millioninteger必須cached_input_nano_usd_per_millioninteger | nullCached input rate; null means no cached rate.
reasoning_nano_usd_per_millioninteger | nulleffective_atstring | nullOptional timestamp with a timezone offset.
service_tier_pricing_enabledboolean | nulltrue requires
service_tier_rates, false clears tier pricing, null leaves it unchanged.service_tier_ratesobject | nullいずれか
object
flexobject | nullいずれか
object
inputinteger | nullcached_inputinteger | nullcache_creation_inputinteger | nullcache_creation_1h_inputinteger | nulloutputinteger | nullreasoninginteger | nulllong_contextobject | nulllong_context
input_threshold_tokensinteger必須inputinteger | nullcached_inputinteger | nullcache_creation_inputinteger | nullcache_creation_1h_inputinteger | nulloutputinteger | nullreasoninginteger | null
priorityobject | nullいずれか
object
inputinteger | nullcached_inputinteger | nullcache_creation_inputinteger | nullcache_creation_1h_inputinteger | nulloutputinteger | nullreasoninginteger | nulllong_contextobject | nulllong_context
input_threshold_tokensinteger必須inputinteger | nullcached_inputinteger | nullcache_creation_inputinteger | nullcache_creation_1h_inputinteger | nulloutputinteger | nullreasoninginteger | null
update_limits
max_concurrencyinteger | nulladvertised_tpsnumber | nullAdvertised output tokens per second.
update_model
wire_idstring必須pricesobject | nullいずれか
object
input_nano_usd_per_millioninteger必須output_nano_usd_per_millioninteger必須cached_input_nano_usd_per_millioninteger | nullCached input rate; null means no cached rate.
reasoning_nano_usd_per_millioninteger | nulleffective_atstring | nullOptional timestamp with a timezone offset.
data_policyobject | nullいずれか
object
retains_promptsboolean必須retention_daysinteger | nullDays prompts are kept.
trains_on_databoolean必須zero_data_retentionboolean必須policy_urlstring | nullPublic https URL of the policy.
dispatchobject | nullいずれか
object
scale_up_secondsinteger | nullWarm-up time before saturation counts against the lane.
overflow_policyenumWhat happens once saturated.
max_concurrencyinteger | nullDeclared cap on in-flight requests for this model.
requests_per_minuteinteger | nullDeclared per-account requests per minute (observed, not enforced).
tokens_per_minuteinteger | nullDeclared per-account tokens per minute (observed, not enforced).
effective_atstring | nullRecorded on a request that lands pending (
update_limits). Must carry a timezone offset.smoke_api_keystring | nullEndpoint key for the
add_modelssmoke when no house key is stored. Used for the probe only, never stored. Ignored for other kinds.
レスポンス
201The recorded request:
status: appliedforadd_models,update_pricesandupdate_model,status: pendingforupdate_limits.レスポンス
idstring必須kindenum必須statusenum必須payloadobject必須The validated payload as stored.
effective_atstring | null必須review_notestring | null必須The reviewer's note on a reviewed request.
errorstring | null必須Why an approved request failed to apply.
created_atstring必須applied_atstring | null必須
400Refused: the manifest review found errors (
request refused: <code>: <message>; ..., for exampleunknown-wire-idon a price change), the smoke test failed (code: smoke_failed, the upstream error per wire id verbatim), or the provider has no public https base_url to probe.レスポンス
errorstring必須Human-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
401Missing, unknown or revoked API key.
レスポンス
errorstring必須Human-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
403The key is valid but may not perform this action (for example an inference key on a provisioning-key route, or a feature outside your plan).
レスポンス
errorstring必須Human-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
404The resource does not exist or belongs to another organization.
レスポンス
errorstring必須Human-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
409An
add_modelssmoke needs a key and none is available (ahouse_keyprovider with no stored key and nosmoke_api_key), or the catalog write conflicted.レスポンス
errorstring必須Human-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
422The body failed validation,
payloaddoes not matchkind, anadd_modelsbatch exceeds 200 models, or the catalog refused the write.429An
update_modeledit was filed less than 24 hours after the previous one.レスポンス
errorstring必須Human-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
リクエスト
curl -X POST https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider/requests \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"kind": "add_models",
"payload": {
"models": [
{
"wire_id": "meta-llama/llama-4.1-70b-instruct",
"binding": {
"kind": "existing",
"slug": "llama-4.1-70b-instruct"
},
"prices": {
"input_nano_usd_per_million": 350000000,
"output_nano_usd_per_million": 900000000,
"cached_input_nano_usd_per_million": 35000000
},
"capabilities": {
"supports_streaming": true,
"supports_parallel_tool_calls": true,
"reports_cached_input_tokens": true
},
"context_window": 131072,
"data_policy": {
"retains_prompts": false,
"trains_on_data": false,
"zero_data_retention": true
},
"rpm": 600,
"tpm": 2000000
}
]
},
"smoke_api_key": "sk-acme-probe-7d2c9e4b1a6f"
}'レスポンス
{
"id": "8a4c2e61-7b9d-4f03-a1e5-c6d8b0f2e394",
"kind": "add_models",
"status": "applied",
"payload": {
"models": [
{
"wire_id": "meta-llama/llama-4.1-70b-instruct",
"binding": {
"kind": "existing",
"slug": "llama-4.1-70b-instruct"
},
"prices": {
"input_nano_usd_per_million": 350000000,
"output_nano_usd_per_million": 900000000,
"cached_input_nano_usd_per_million": 35000000,
"reasoning_nano_usd_per_million": null,
"effective_at": null
}
}
]
},
"effective_at": null,
"review_note": null,
"error": null,
"created_at": "2026-11-19T10:12:44.903Z",
"applied_at": "2026-11-19T10:12:44.903Z"
}https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider/requests