Skip to main content
POST
External OpenAI-compatible inference
External routes are for clients that can set an OpenAI-compatible baseURL and bearer token but do not understand x402 challenge flows. They use Compose Key auth only.

Routes

Headers

string
required
Bearer compose-.... Missing or invalid keys return an OpenAI-shaped 401.

Request body

string
required
Public catalog model ID exactly as returned by /external/v1/models.
array
Chat Completions message array.
string | array
Responses or embeddings input.
array
OpenAI function tool definitions. Tool calls are returned in OpenAI shape when the provider emits them.
object
Preserved for streaming clients. Usage inclusion is forced when needed for metering.

Diagnostic headers

External response bodies do not include compose_receipt. Upstream content-filter errors are sanitized while keeping the diagnostic headers above.