/api/models/{slug}/providersAdd a deployment to a model
On a public model the new deployment is your organization's private route to it; on your own model it extends the model. Always customer_managed. Idempotent on the deployment identity: a replay answers 200. A deployment with a base_url needs a verified payment method and counts toward 10 new endpoints per hour. Add the returned id to the waterfall to route through it.
Authentication: Bearer API key in the Authorization header
Path parameters
slugstringrequiredModel slug.
Request body
providerenumrequiredprovider_model_idstringrequiredbase_urlstring | nullRequired for
localandmodal; forbidden for fixed-origin providers. An explicit http(s) endpoint with optional port and path, no userinfo, query or fragment.regionstring | nullapi_versionstring | nullprovider_connection_idstring | nullPin to one of your API-key BYOK connections of the same provider; null resolves by provider at request time.
input_nano_usd_per_millioninteger | nullInteger nano-USD per million tokens; null = unknown.
cached_input_nano_usd_per_millioninteger | nullcache_write_input_nano_usd_per_millioninteger | nullcache_write_1h_input_nano_usd_per_millioninteger | nulllong_context_cache_write_input_nano_usd_per_millioninteger | nulllong_context_cache_write_1h_input_nano_usd_per_millioninteger | nulloutput_nano_usd_per_millioninteger | nullreasoning_nano_usd_per_millioninteger | nullpricing_sourcestring | nullWhere the rates come from (for example
self-reported).provider-free-tieris reserved and refused.capabilitiesobjectWire capabilities. Seeded from the model's
supported_params; explicit keys win.uptime_30dnumber | nullthroughput_tpsnumber | nulllatency_p50_msnumber | nullstats_sourceenumendpoint_api_keystring | nulllocalonly. Sent to your endpoint asAuthorization: Bearer <key>. Stored in a vault, never returned.org_idstring | nullOwning organization. Implied by a key.
Responses
201Created. A replay answers 200 with the same row.
Response
idstringDeployment id, or
byok:{connection_id}for a lane served by your own provider connection. This is the token a waterfall write uses.model_idstringproviderstringProvider id as shown to you; platform lanes run on our own capacity show
experiential_cloud.provider_model_idstringThe provider's wire id.
base_urlstring | nullEndpoint of a customer-run (
local,modal) deployment.regionstring | nullapi_versionstring | nullowning_org_idstring | nullYour organization for a private lane; null for a public lane.
provider_connection_idstring | nullThe pinned BYOK connection, if any.
connection_aliasstring | nullOn BYOK lanes only: the connection's account alias, which tells two same-provider accounts apart.
route_idstring | nullOpaque per-organization handle for selecting exactly this lane on a request. Null without an organization context or when the lane cannot serve your traffic.
provider_statusobjectThe provider's own public status report for this lane. Advisory only, never routing input.
provider_status
stateenumofficial_urlstring | nullchecked_atstring | nullscopestringlimitationstringincidentsarray<object>advisoryboolean
provider_logo_urlstringRegistry provider logo, when one exists. Omitted otherwise.
billing_sourceenumhost_managedbills your credits;customer_managedbills your own provider or endpoint.input_nano_usd_per_millioninteger | nullcached_input_nano_usd_per_millioninteger | nullcache_write_input_nano_usd_per_millioninteger | nullcache_write_1h_input_nano_usd_per_millioninteger | nulllong_context_cache_write_input_nano_usd_per_millioninteger | nulllong_context_cache_write_1h_input_nano_usd_per_millioninteger | nullcache_write_12h_input_nano_usd_per_millioninteger | nullNull on a lane supporting 12-hour cache means 2.5 times the input rate.
output_nano_usd_per_millioninteger | nullreasoning_nano_usd_per_millioninteger | nullimage_output_nano_usd_per_millioninteger | nullGenerated-image tokens rate; null bills them as output.
long_context_threshold_tokensinteger | nullOnce reported input tokens reach this, the
long_context_*rates price the whole request. Null means flat pricing.long_context_input_nano_usd_per_millioninteger | nulllong_context_cached_input_nano_usd_per_millioninteger | nulllong_context_output_nano_usd_per_millioninteger | nulllong_context_reasoning_nano_usd_per_millioninteger | nullunit_pricesobjectA per-unit lane's only meter.
unit_prices
kindenumratesobjectInteger nano-USD per unit by variant (
""is the flat rate).
off_peak_pricingobjectOff-peak price card with its weekly UTC peak windows (
prices,peak_windows,off_peak_dates). The headline rates are the peak price. Omitted when absent.pricing_sourcestring | nullpricing_effective_atstring | nullcapabilitiesobjectWire capabilities the gateway enforces (for example
supports_tools,supported_reasoning_efforts).uptime_30dnumber | nullPercent.
uptime_recentnumber | nullCompleted share (percent) of the route's most recent requests; null under 50 requests.
uptime_recent_requestsinteger | nullthroughput_tpsnumber | nullObserved decode tokens per second.
latency_p50_msnumber | nullObserved median time to first token.
request_latency_p50_msnumber | nullObserved median end-to-end latency of calls with no first token.
stats_sourceenumstatusstringroutableboolean | nullWhether the gateway's active plan routes this platform lane. Null when not applicable.
requires_paymentbooleanPaid-only lane (a completed top-up opens it).
requires_purchasebooleanPurchase-required lane (a real purchase, not the $1 verification, opens it).
zdr_onlybooleanServes only requests routed under zero data retention.
hidden_fallbackbooleanavailable_to_orgboolean | nullWhether your organization may use this closed lane. Null without an organization context or for an open lane.
zero_data_retentionboolean | nullDetail route only. Null means no posture coverage, which a require-ZDR policy treats as non-compliant.
zero_data_retention_on_requestboolean | nullZDR only when dispatched under the gateway's per-request ZDR constraint.
processing_region_setsarray<array<string>>plan_discountsobject | nullOne of
object
freenumberpronumbermaxnumberultranumber
service_tier_ratesobject | nullPer-tier rate cards (
flex,priority) in nano-USD per million tokens when the lane prices processing tiers.ladder_rankinteger | nullDisplay-only position among the model's public platform lanes.
ladder_lane_countinteger | nullladder_scorenumber | nullladder_factorsobject | nullendpoint_credential_last4string | nullLast four characters of a stored endpoint API key.
created_atstringupdated_atstring
401Missing, unknown or revoked API key.
Response
errorstringrequiredHuman-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 organization is under review (
org_under_review), or abase_urldeployment needs a verified payment method (endpoint_requires_verified_payment).Response
errorstringrequiredHuman-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 model, the organization, or the pinned
provider_connection_idis not visible to you.Response
errorstringrequiredHuman-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).
409The deployment identity exists with different attributes.
Response
errorstringrequiredHuman-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).
422Body validation failed (for example
endpoint_api_keyon a non-localprovider, or abase_urlwith a query string), or a schema rule such aspricing_source_reserved.429The organization created 10 custom endpoints in the last hour (
endpoint_creation_rate_limited).Response
errorstringrequiredHuman-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).
Request
curl -X POST https://api.experientiallabs.ai/api/models/my-local-model/providers \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"provider": "local",
"provider_model_id": "my-model-fp8",
"base_url": "https://gpu2.acme.dev:8000/v1",
"endpoint_api_key": "sk-acme-endpoint-9b3e5d1a7c",
"pricing_source": "self-reported"
}'Response
{
"id": "7a3f1c28-9e4d-4b60-a5d2-3c8e1f0b7d46",
"model_id": "0b8f3d2a-5c61-4e7f-9a12-7d4e6b1c9f30",
"provider": "local",
"provider_model_id": "my-model-fp8",
"base_url": "https://gpu2.acme.dev:8000/v1",
"region": null,
"api_version": null,
"owning_org_id": "3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10",
"provider_connection_id": null,
"billing_source": "customer_managed",
"input_nano_usd_per_million": null,
"cached_input_nano_usd_per_million": null,
"cache_write_input_nano_usd_per_million": null,
"cache_write_1h_input_nano_usd_per_million": null,
"long_context_cache_write_input_nano_usd_per_million": null,
"long_context_cache_write_1h_input_nano_usd_per_million": null,
"output_nano_usd_per_million": null,
"reasoning_nano_usd_per_million": null,
"long_context_threshold_tokens": null,
"long_context_input_nano_usd_per_million": null,
"long_context_cached_input_nano_usd_per_million": null,
"long_context_output_nano_usd_per_million": null,
"long_context_reasoning_nano_usd_per_million": null,
"pricing_source": "self-reported",
"pricing_effective_at": null,
"capabilities": {},
"uptime_30d": null,
"throughput_tps": null,
"latency_p50_ms": null,
"stats_source": null,
"status": "active",
"endpoint_credential_last4": "7c1a",
"created_at": "2026-11-19T15:10:42.330118+00:00",
"updated_at": "2026-11-19T15:10:42.330118+00:00"
}https://api.experientiallabs.ai/api/models/my-local-model/providers