v2

latestOpenAPI 3.1.02026-08-0514431.6 KB

Create a chat completion

post/v1/chat/completions

Headers

X-Speko-Objective'latency' | 'quality' | 'cost' | 'balanced'

Routing objective. Defaults to the route policy.

X-Speko-Languagestring

BCP 47 language tag used for benchmark selection and provider transcription.

X-Speko-Allowstring

Comma-separated providers or provider:model ids to allow.

X-Speko-Denystring

Comma-separated providers or provider:model ids to exclude.

X-Speko-Max-Pricenumber

Maximum published benchmark price for the request stage: STT in USD per minute, LLM in USD per 1M tokens, or TTS in USD per 1M characters. Candidates without a published price are excluded when this constraint is set.

Request body

modelstring required

Use auto for benchmark-led routing, or provide a model id.

messagesobject[] required

streamboolean

Response

OpenAI-compatible completion or event stream