API referenceGateway
Models
Discover the aliases your key can address and what each resolves to.
codai is the one name you need; the rest are workload aliases (codai-fast, codai-deep, …) and a few concrete upstream ids. The catalog is filtered by your key's allow-list. Background on tiers and routing: models guide.
Authorization
bearerAuth AuthorizationBearer <token>
A codai API key (codai_ prefix). Ephemeral tokens from POST /v1/tokens are accepted only by /v1/realtime.
In: header
Header Parameters
x-request-id?string
Client correlation id; echoed back as x-codai-trace-id and persisted on the usage row.
Length
length <= 128Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/models"{ "object": "list", "data": [ { "id": "codai", "object": "model", "created": 0, "owned_by": "codai", "codai": { "kind": "alias", "type": "chat", "routesTo": [ "claude-fable-5-1", "gpt-5" ], "capabilities": { "tools": true, "vision": true, "streaming": true, "maxInputTokens": 0, "maxOutputTokens": 0 }, "pricing": { "input_usd_per_mtok": 0, "output_usd_per_mtok": 0, "cached_input_usd_per_mtok": 0, "cache_write_usd_per_mtok": 0, "exact": true, "by_route": { "property1": {}, "property2": {} } } } } ]}