Batuta LLM

Create a chat completion (OpenAI-compatible)

OpenAI-compatible chat completions endpoint. Pass any model id from GET /models as the model field; pass the synthetic id batuta-auto to let Batuta classify the prompt and route to a tier (fast / balanced / premium) automatically.

Routing headers (optional)

  • X-Batuta-Force-Tier: fast | balanced | premium — bypass the classifier and pin a tier for this call. Only meaningful when model = batuta-auto.
  • X-Batuta-Session-ID: <uuid> — opaque session id. When provided, the proxy attributes prior assistant turns in this session to the model that produced them so downstream models can calibrate trust on cross-model conversations.

Routing response headers

  • X-Batuta-Routed-From: batuta-auto (when input was routed)
  • X-Batuta-Routed-To: <upstream-model-id>
  • X-Batuta-Tier: fast | balanced | premium
post/api/v1/chat/completions

Request

  • Base URL: https://getorquesta.com
  • URL: https://getorquesta.com/api/v1/chat/completions
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Headers

X-Batuta-Force-Tier'fast' | 'balanced' | 'premium'

Pin the routing tier. Only honored when model = batuta-auto.

X-Batuta-Session-IDstring uuid

Opaque per-conversation id for cross-model attribution.

Request body

modelstring required

Any id returned by GET /models, or the synthetic batuta-auto to enable classifier-driven routing.

streamboolean
temperaturenumber
max_tokensinteger

Example request

{
  "model": "batuta-auto"
}

Response

Successful completion (or first SSE chunk if stream=true).

idstring required
object'chat.completion' required
createdinteger required

Unix epoch seconds

modelstring required

The upstream model that actually generated the completion

Changes

No recorded changes to this operation across all 1 revision of this API.