Codius
APIReference

Create a Messages-compatible response

POST
/v1/messages

Messages-compatible adapter used when Codius App runs Claude Code with Codius models. It uses the same authorization, metering, limits, and request IDs as Chat Completions. Requires the inference:create scope.

Authorization

apiKey
AuthorizationBearer <token>

A Codius organization API key, sent as Authorization: Bearer codius_live_…. Keys carry a subset of the models:read, inference:create, and usage:read scopes — never billing or admin permissions.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

model*string
max_tokens*integer
Range1 <= value
messages*array<>
Items1 <= items
system?string|array<>
stream?boolean
Defaultfalse
tools?array<>
[key: string]?any

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/messages" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "max_tokens": 1,    "messages": [      {}    ]  }'
{}

Create a chat completion POST

Creates a model response for a conversation. Requires the `inference:create` scope. Set `stream: true` to receive Server-Sent Events. The stream emits `chat.completion.chunk` objects and terminates with exactly one `data: [DONE]` marker. Pass `stream_options.include_usage: true` to receive a final chunk carrying the token usage block. Requests that use a capability the target model does not support are rejected with `unsupported_feature` rather than silently degraded. Only `n: 1` is supported.

Create an OpenAI Responses-compatible response POST

Responses-compatible adapter for coding agents managed by Codius App. It uses the same model catalog, authorization, metering, limits, and request IDs as Chat Completions. Requires the `inference:create` scope.