v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-2682245.2 KB

openai-compat

Chat completions (OpenAI-compatible)

OpenAI-compatible chat completions endpoint. Works with the OpenAI Python SDK by setting base_url="https://api.pioneer.ai/v1". Set stream=true for SSE streaming. The response includes a x_pioneer extension field with inference_id and routed_model.

post/v1/chat/completions

Request body

modelstring required

Model ID, project name, or pioneer/auto for automatic routing.

temperaturenumber

max_tokensinteger

streamboolean

response_formatobject

top_pnumber

storeboolean

Persist to inference history. Set false to opt out.

metadataobject

Pioneer reads metadata.project_id for attribution.

reasoningobject

Opt-in reasoning controls (OpenRouter-normalized). Keys: enabled, effort (minimal/low/medium/high/xhigh/none), max_tokens, exclude, mode (manual/adaptive, Anthropic-only), display (summarized/omitted, Anthropic-only). effort and max_tokens are mutually exclusive.

seedinteger

ninteger

presence_penaltynumber

frequency_penaltynumber

userstring

Response

Chat completion result. Returns application/json when stream=false (default) and text/event-stream SSE when stream=true. Each SSE event is data: {...}\n\n terminated by data: [DONE]\n\n.

idstring required

object'chat.completion' required

createdinteger required

modelstring required