Creates a model response for the given chat conversation.Auriko routes the request to the optimal provider based on your routing preferences (cost, latency, throughput, etc.).
Auriko Extensions
Beyond OpenAI compatibility, this endpoint supports:
Multi-model routing: Use models[] instead of model to route across multiple models
Routing options: Control provider selection with the routing object
Provider extensions: Pass provider-specific parameters with extensions
Cost transparency: Response includes routing_metadata with cost breakdown
All parameters, request/response schemas, and examples are auto-generated from the OpenAPI specification.
Authorizations
Authorization
string
header
required
API key authentication.
Keys start with ak_ prefix.
Example: Authorization: Bearer ak_live_xxxxxxxxxxxx
Body
application/json
Option 1
Option 2
model
string
required
Model to route to, required for single-model requests.
Mutually exclusive with gateway.models; providing both returns 400.
Sampling temperature (0-2). Some providers restrict this value when reasoning is enabled.
Required range: 0 <= x <= 2
top_p
number
Nucleus sampling parameter. Some providers restrict this value when reasoning is enabled.
Required range: 0 <= x <= 1
max_tokens
integer
Maximum tokens to generate (legacy, use max_completion_tokens)
Required range: x >= 1
max_completion_tokens
integer
Maximum tokens to generate. Reasoning models (o1/o3) use this field instead of max_tokens.
Required range: x >= 1
reasoning_effort
enum<string>
Controls reasoning effort for supported models. Auriko translates
this into each provider's native reasoning control.
See /guides/extensions-and-thinking for per-provider behavior.
Available options:
none,
minimal,
low,
medium,
high,
xhigh,
max,
off
reasoning
object
Controls reasoning visibility in the response. Set exclude: true to omit
reasoning fields (reasoning_content, reasoning, and streaming reasoning
deltas) from the response. The model still reasons and reasoning tokens are
billed; use reasoning_effort to control reasoning depth.
Keys other than exclude (for example OpenRouter's effort) are ignored
and surfaced as an unsupported_field warning in routing_metadata.warnings.
See /guides/extensions-and-thinking for details.
Show child attributes
stop
stringstring[]
Stop sequences. Restrictions vary by provider and model.
presence_penalty
number
Presence penalty (-2 to 2). Not supported by all providers.
Required range: -2 <= x <= 2
frequency_penalty
number
Frequency penalty (-2 to 2). Not supported by all providers.
Required range: -2 <= x <= 2
logit_bias
object
Token logit bias. Not supported by all providers.
Show child attributes
seed
integer
Random seed for reproducibility
top_k
integer
Top-K sampling. Restricted by some providers when reasoning is enabled. Supported by Anthropic, Google, and vLLM.
Required range: x >= 1
min_p
number
Min-P sampling. Supported by some vLLM providers.
Required range: 0 <= x <= 1
top_a
number
Top-A sampling. Supported by some vLLM providers.
Required range: 0 <= x <= 1
repetition_penalty
number
Repetition penalty. Supported by vLLM providers.
tools
object[]
Tools the model can call
Show child attributes
tool_choice
enum<string>object
Available options:
auto,
required,
none
parallel_tool_calls
boolean
Allow parallel tool calls
functions
object[]
deprecated
Deprecated. Use tools instead. Auto-converted.
Show child attributes
function_call
enum<string>object
deprecated
Deprecated. Use tool_choice instead. Auto-converted.
Available options:
none,
auto
response_format
object
Show child attributes
stream
boolean
default:false
Enable streaming responses
stream_options
object
Show child attributes
user
string
User identifier for abuse detection
n
integer
default:1
Number of completions to generate. Not supported by all providers.
Required range: 1 <= x <= 10
logprobs
boolean
Return log probabilities. Not supported by all providers.
top_logprobs
integer
Number of top logprobs to return. Requires logprobs support.
Required range: 0 <= x <= 20
web_search_options
object
Web search configuration. Supported by OpenAI.
verbosity
string
Output verbosity control. Supported by OpenAI.
prompt_cache_key
string
Prompt caching identifier. Supported by OpenAI.
safety_identifier
string
Safety policy identifier. Supported by OpenAI.
gateway
object
Auriko routing, metadata, and multi-model configuration. Omit for default single-model routing.
Show child attributes
extensions
object
Auriko extensions for provider-specific passthrough.
For reasoning control, use the top-level reasoning_effort parameter
instead of extensions.
Provider Passthrough
Pass provider-specific parameters directly:
anthropic: Anthropic-specific parameters
openai: OpenAI-specific parameters
google: Google/Gemini-specific parameters
deepseek: DeepSeek-specific parameters
Passthrough parameters are forwarded as-is to the target provider.
Show child attributes
Response
Successful completion.
For streaming (stream: true), responses are Server-Sent Events.
Each event is a ChatCompletionChunk. The final chunk has choices: []
(empty) and contains usage and routing_metadata. Stream ends with
data: [DONE].
id
string
required
Unique completion identifier
object
string
required
Allowed value: "chat.completion"
created
integer
required
Unix timestamp of creation
model
string
required
Model used for completion
choices
object[]
required
Completion choices
Show child attributes
usage
object
Token usage statistics. Present in virtually all responses.
May be absent in rare cases where upstream provider does not report usage.
Show child attributes
system_fingerprint
string
Backend fingerprint for reproducibility. Not all models include this field.
routing_metadata
object
Routing decision metadata included in successful responses.
8 STABLE fields (4 required + 4 optional) in the current public contract.
Show child attributes
service_tier
string | null
The service tier used for processing the request. Present for OpenAI-routed models.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Auriko","colors":{"primary":"#4779EA","light":"#5A8AF0","dark":"#457CFD"},"logo":{"light":"https://mintcdn.com/auriko/ZctT69z8zlG3FLhm/logo/light.svg?fit=max\u0026auto=format\u0026n=ZctT69z8zlG3FLhm\u0026q=85\u0026s=9160396833137f89a62e6297d0da13e3","dark":"https://mintcdn.com/auriko/ZctT69z8zlG3FLhm/logo/dark.svg?fit=max\u0026auto=format\u0026n=ZctT69z8zlG3FLhm\u0026q=85\u0026s=a4b0a27dddb8e89f557c88810e83c0d6","href":"https://www.auriko.ai"},"favicon":"https://mintcdn.com/auriko/yhqJ6Vvvah9BLEHr/favicon.svg?fit=max\u0026auto=format\u0026n=yhqJ6Vvvah9BLEHr\u0026q=85\u0026s=c69b6b12a2be60ef2e4ca140b765fb07","api":{"openapi":"openapi.yaml","playground":{"display":"simple"},"examples":{"languages":["python","javascript","bash"]}},"appearance":{"default":"light"},"background":{"color":{"light":"#FCFCFC","dark":"#121212"}},"navbar":{"links":[{"href":"https://auriko.ai/dashboard","label":"Dashboard"},{"href":"https://status.auriko.ai/","label":"Status"}],"primary":{"type":"button","label":"Get API Key","href":"https://auriko.ai/signup?redirectTo=%2Fdashboard%3Ftab%3Dapi-keys"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/auriko"}},"seo":{},"fonts":{"family":"Geist"},"integrations":{"ga4":{"measurementId":"G-T9E92EL136"},"posthog":{"apiKey":"phc_vN8XY29aw4p545BJEggF3maB23C8tRqidG5hpUP4Et6J","apiHost":"https://us.i.posthog.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"auriko","hasAudioNarration":false,"actualSubdomain":"auriko","customDomains":["docs.auriko.ai"],"gitSource":{"type":"github","owner":"auriko-ai","repo":"auriko","deployBranch":"main","contentDirectory":"docs-site","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6abd4cc98c699ce8aa4321dc","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentation","count":105},{"language":"default","tag":"Specifications","count":68},{"language":"default","tag":"Error code reference","count":63},{"language":"default","tag":"API Reference","count":50},{"language":"default","tag":"Guides","count":11},{"language":"default","tag":"SDK","count":10},{"language":"default","tag":"BYOK","count":7},{"language":"default","tag":"Frameworks","count":7},{"language":"default","tag":"API Keys","count":6},{"language":"default","tag":"Integrations","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"img.nav-logo{height:1.25rem!important}"}]}
{"page":{"pagePath":"api-reference/chat-completions","slug":"/api-reference/chat-completions","pageMetadata":{"title":"Create Chat Completion","description":"Create a model response for a chat conversation with intelligent routing","openapi":"POST /v1/chat/completions","last_verified":"2026-04-27","href":"/api-reference/chat-completions"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create a model response for a chat conversation with intelligent routing\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Note}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Creates a model response for the given chat conversation.`}),`\n`,_jsx(_components.p,{children:`Auriko routes the request to the optimal provider based on your routing preferences (cost, latency, throughput, etc.).`}),`\n`,_jsx(Heading,{level:`2`,id:`auriko-extensions`,children:`Auriko Extensions`}),`\n`,_jsx(_components.p,{children:`Beyond OpenAI compatibility, this endpoint supports:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Multi-model routing`}),`: Use `,_jsx(_components.code,{children:`models[]`}),` instead of `,_jsx(_components.code,{children:`model`}),` to route across multiple models`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Routing options`}),`: Control provider selection with the `,_jsx(_components.code,{children:`routing`}),` object`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Provider extensions`}),`: Pass provider-specific parameters with `,_jsx(_components.code,{children:`extensions`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Cost transparency`}),`: Response includes `,_jsx(_components.code,{children:`routing_metadata`}),` with cost breakdown`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`All parameters, request/response schemas, and examples are auto-generated from the `,_jsx(_components.a,{href:`/api-reference/overview`,children:`OpenAPI specification`}),`.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Chat Completion","description":"Create a model response for a chat conversation with intelligent routing","openapi":"POST /v1/chat/completions","last_verified":"2026-04-27","href":"/api-reference/chat-completions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Auriko Extensions","slug":"auriko-extensions","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createChatCompletion","x-stability":"stable","summary":"Create a chat completion","description":"Create a model response for a chat conversation with intelligent routing","security":["5dad3c74-38ba-4750-ae5a-89f23079cb7a"],"tags":["Chat"],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl https://api.auriko.ai/v1/chat/completions \\\n -H \"Authorization: Bearer $AURIKO_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"model\": \"gpt-4o\",\n \"messages\": [{\"role\": \"user\", \"content\": \"Hello\"}]\n }'\n"},{"lang":"python","label":"Python","source":"from auriko import Client\n\nclient = Client()\nresponse = client.chat.completions.create(\n model=\"gpt-4o\",\n messages=[{\"role\": \"user\", \"content\": \"Hello\"}]\n)\nprint(response.choices[0].message.content)\n"},{"lang":"typescript","label":"TypeScript","source":"import { Client } from \"@auriko/sdk\";\n\nconst client = new Client();\nconst response = await client.chat.completions.create({\n model: \"gpt-4o\",\n messages: [{ role: \"user\", content: \"Hello\" }],\n});\nconsole.log(response.choices[0].message.content);\n"},{"lang":"python","label":"Python (with gateway.metadata)","source":"from auriko import Client\nfrom auriko.route_types import GatewayOptions\n\nclient = Client()\nresponse = client.chat.completions.create(\n model=\"gpt-4o\",\n messages=[{\"role\": \"user\", \"content\": \"Hello\"}],\n gateway=GatewayOptions(\n metadata={\n \"tags\": [\"production\", \"gpt-4o\"],\n \"user_id\": \"user_123\",\n \"custom_fields\": {\"env\": \"production\"},\n },\n ),\n)\nprint(response.choices[0].message.content)\n"},{"lang":"python","label":"Python (OpenAI-compatible)","source":"import os\nfrom openai import OpenAI\n\nclient = OpenAI(\n api_key=os.environ[\"AURIKO_API_KEY\"],\n base_url=\"https://api.auriko.ai/v1\"\n)\nresponse = client.chat.completions.create(\n model=\"gpt-4o\",\n messages=[{\"role\": \"user\", \"content\": \"Hello\"}]\n)\nprint(response.choices[0].message.content)\n"}],"requestBody":"0434a2e4-1350-4c86-87a4-a51d0627660a","responses":{"200":"d5e22c9d-bd82-435f-8da0-11e5f3990cb7","400":"3fe70ce2-cf91-4e44-8529-ecf396067b17","401":"21fdaee6-67bd-4c79-a7cd-da90c0dc5619","404":"dd345fa2-56ef-4e3c-a68e-5d9bc6a7b548","429":"42f56ad1-816a-4f2c-8430-296d0b699a91","500":"cc1c36b8-777c-4fc5-a46c-fde92feaa79f","502":"963156ab-b611-4814-a2dd-fdf8ed084621","503":"86105ee1-d45e-4658-8308-d6fafbf8dc9a","504":"674919ce-706b-48d3-8eda-163a92885623"},"method":"post","type":"path","servers":["7a684522-107c-44d9-947d-4e0fc7defa27"],"path":"/v1/chat/completions","baseUrlOptions":["https://api.auriko.ai"],"title":"Create a chat completion","codeSamples":[{"label":"curl","lang":"bash","source":"curl https://api.auriko.ai/v1/chat/completions \\\n -H \"Authorization: Bearer $AURIKO_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"model\": \"gpt-4o\",\n \"messages\": [{\"role\": \"user\", \"content\": \"Hello\"}]\n }'\n"},{"label":"Python","lang":"python","source":"from auriko import Client\n\nclient = Client()\nresponse = client.chat.completions.create(\n model=\"gpt-4o\",\n messages=[{\"role\": \"user\", \"content\": \"Hello\"}]\n)\nprint(response.choices[0].message.content)\n"},{"label":"TypeScript","lang":"typescript","source":"import { Client } from \"@auriko/sdk\";\n\nconst client = new Client();\nconst response = await client.chat.completions.create({\n model: \"gpt-4o\",\n messages: [{ role: \"user\", content: \"Hello\" }],\n});\nconsole.log(response.choices[0].message.content);\n"},{"label":"Python (with gateway.metadata)","lang":"python","source":"from auriko import Client\nfrom auriko.route_types import GatewayOptions\n\nclient = Client()\nresponse = client.chat.completions.create(\n model=\"gpt-4o\",\n messages=[{\"role\": \"user\", \"content\": \"Hello\"}],\n gateway=GatewayOptions(\n metadata={\n \"tags\": [\"production\", \"gpt-4o\"],\n \"user_id\": \"user_123\",\n \"custom_fields\": {\"env\": \"production\"},\n },\n ),\n)\nprint(response.choices[0].message.content)\n"},{"label":"Python (OpenAI-compatible)","lang":"python","source":"import os\nfrom openai import OpenAI\n\nclient = OpenAI(\n api_key=os.environ[\"AURIKO_API_KEY\"],\n base_url=\"https://api.auriko.ai/v1\"\n)\nresponse = client.chat.completions.create(\n model=\"gpt-4o\",\n messages=[{\"role\": \"user\", \"content\": \"Hello\"}]\n)\nprint(response.choices[0].message.content)\n"}],"requestExampleLanguages":["python","javascript","bash"],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["messages","model"],"properties":{"model":{"type":"string","example":"gpt-4o","description":"Model to route to, required for single-model requests.\nMutually exclusive with `gateway.models`; providing both returns 400.\n\nExamples: `gpt-4o`, `claude-sonnet-4-6`, `llama-3.3-70b-instruct`\n","isRequired":true,"uniqueKey":"oneOf.0.model","typeLabel":"string"},"messages":{"type":"array","items":{"oneOf":[{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","const":"system","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.0.role","typeLabel":"string"},"content":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.0.content.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"object","required":["type","text"],"properties":{"type":{"type":"string","const":"text","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.0.content.oneOf.1.items.[INDEX].type","typeLabel":"string"},"text":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.0.content.oneOf.1.items.[INDEX].text","typeLabel":"string"},"cache_control":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"ephemeral","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.0.content.oneOf.1.items.[INDEX].cache_control.type","typeLabel":"string"}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.0.content.oneOf.1.items.[INDEX].cache_control","typeLabel":"object"}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.0.content.oneOf.1.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.0.content.oneOf.1","typeLabel":"object[]"}],"isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.0.content","typeLabel":"string | object[]"},"name":{"type":"string","uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.0.name","typeLabel":"string"}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","const":"user","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1.role","typeLabel":"string"},"content":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1.content.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"object","required":["type","text"],"properties":{"type":{"type":"string","const":"text","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.0.type","typeLabel":"string"},"text":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.0.text","typeLabel":"string"},"cache_control":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"ephemeral","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.0.cache_control.type","typeLabel":"string"}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.0.cache_control","typeLabel":"object"}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","image_url"],"properties":{"type":{"type":"string","const":"image_url","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.1.type","typeLabel":"string"},"image_url":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.1.image_url.url","typeLabel":"string\u003curi>"},"detail":{"type":"string","enum":["auto","low","high"],"default":"auto","uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.1.image_url.detail","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.1.image_url","typeLabel":"object"},"cache_control":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"ephemeral","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.1.cache_control.type","typeLabel":"string"}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.1.cache_control","typeLabel":"object"}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1.content.oneOf.1","typeLabel":"object[]"}],"isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1.content","typeLabel":"string | object[]"},"name":{"type":"string","uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1.name","typeLabel":"string"}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["role"],"properties":{"role":{"type":"string","const":"assistant","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.role","typeLabel":"string"},"content":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.content.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.content.oneOf.1","typeLabel":"null"},{"type":"array","items":{"type":"object","required":["type","text"],"properties":{"type":{"type":"string","const":"text","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.content.oneOf.2.items.[INDEX].type","typeLabel":"string"},"text":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.content.oneOf.2.items.[INDEX].text","typeLabel":"string"},"cache_control":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"ephemeral","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.content.oneOf.2.items.[INDEX].cache_control.type","typeLabel":"string"}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.content.oneOf.2.items.[INDEX].cache_control","typeLabel":"object"}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.content.oneOf.2.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.content.oneOf.2","typeLabel":"object[]"}],"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.content","typeLabel":"string | null | object[]"},"name":{"type":"string","uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.name","typeLabel":"string"},"tool_calls":{"oneOf":[{"type":"array","items":{"type":"object","required":["id","type","function"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.tool_calls.oneOf.0.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","const":"function","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.tool_calls.oneOf.0.items.[INDEX].type","typeLabel":"string"},"function":{"type":"object","required":["name","arguments"],"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.tool_calls.oneOf.0.items.[INDEX].function.name","typeLabel":"string"},"arguments":{"type":"string","description":"JSON string of function arguments","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.tool_calls.oneOf.0.items.[INDEX].function.arguments","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.tool_calls.oneOf.0.items.[INDEX].function","typeLabel":"object"},"provider_signature":{"type":"string","description":"Provider-specific cryptographic signature for function-call round-trip.\nEcho back on next request for multi-turn correctness.\n","uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.tool_calls.oneOf.0.items.[INDEX].provider_signature","typeLabel":"string"}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.tool_calls.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.tool_calls.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","required":["id","type","function"],"properties":{"id":{"type":"string"},"type":{"type":"string","const":"function"},"function":{"type":"object","required":["name","arguments"],"properties":{"name":{"type":"string"},"arguments":{"type":"string","description":"JSON string of function arguments"}}},"provider_signature":{"type":"string","description":"Provider-specific cryptographic signature for function-call round-trip.\nEcho back on next request for multi-turn correctness.\n"}}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.tool_calls.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.tool_calls","typeLabel":"object[] | null"},"reasoning":{"oneOf":[{"type":"array","items":{"oneOf":[{"type":"object","description":"Structured reasoning block from thinking models. Discriminated on `type`.\nUsed on both request side (AssistantMessage.reasoning) and response side (Choice.message.reasoning).\n","required":["type","thinking","signature"],"properties":{"type":{"type":"string","const":"thinking","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.reasoning.oneOf.0.items.[INDEX].oneOf.0.type","typeLabel":"string"},"thinking":{"type":"string","description":"The model's reasoning content","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.reasoning.oneOf.0.items.[INDEX].oneOf.0.thinking","typeLabel":"string"},"signature":{"type":"string","description":"Cryptographic signature for multi-turn verification","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.reasoning.oneOf.0.items.[INDEX].oneOf.0.signature","typeLabel":"string"}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.reasoning.oneOf.0.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Structured reasoning block from thinking models. Discriminated on `type`.\nUsed on both request side (AssistantMessage.reasoning) and response side (Choice.message.reasoning).\n","required":["type","data"],"properties":{"type":{"type":"string","const":"redacted","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.reasoning.oneOf.0.items.[INDEX].oneOf.1.type","typeLabel":"string"},"data":{"type":"string","description":"Opaque encrypted reasoning data (pass through verbatim)","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.reasoning.oneOf.0.items.[INDEX].oneOf.1.data","typeLabel":"string"}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.reasoning.oneOf.0.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.reasoning.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Structured reasoning blocks with cryptographic signatures for multi-turn round-trip.\n","uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.reasoning.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"oneOf":[{"type":"object","description":"Structured reasoning block from thinking models. Discriminated on `type`.\nUsed on both request side (AssistantMessage.reasoning) and response side (Choice.message.reasoning).\n","required":["type","thinking","signature"],"properties":{"type":{"type":"string","const":"thinking"},"thinking":{"type":"string","description":"The model's reasoning content"},"signature":{"type":"string","description":"Cryptographic signature for multi-turn verification"}}},{"type":"object","description":"Structured reasoning block from thinking models. Discriminated on `type`.\nUsed on both request side (AssistantMessage.reasoning) and response side (Choice.message.reasoning).\n","required":["type","data"],"properties":{"type":{"type":"string","const":"redacted"},"data":{"type":"string","description":"Opaque encrypted reasoning data (pass through verbatim)"}}}]},"description":"Structured reasoning blocks with cryptographic signatures for multi-turn round-trip.\n","uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.reasoning.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.reasoning","typeLabel":"object[] | null"},"reasoning_content":{"oneOf":[{"type":"string","description":"Reasoning content from the model's previous response. Echo back the value\nfrom the assistant message's reasoning_content field for DeepSeek multi-turn\ntool calling. Other providers accept but ignore this field.\n","uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.reasoning_content.oneOf.0","typeLabel":"string"},{"type":"null","description":"Reasoning content from the model's previous response. Echo back the value\nfrom the assistant message's reasoning_content field for DeepSeek multi-turn\ntool calling. Other providers accept but ignore this field.\n","uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.reasoning_content.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.reasoning_content","typeLabel":"string | null"},"refusal":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.refusal.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.refusal.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.refusal","typeLabel":"string | null"},"function_call":{"deprecated":true,"type":"object","properties":{"name":{"type":"string","uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.function_call.name","typeLabel":"string"},"arguments":{"type":"string","uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.function_call.arguments","typeLabel":"string"}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2.function_call","typeLabel":"object"}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["role","content","tool_call_id"],"properties":{"role":{"type":"string","const":"tool","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.3.role","typeLabel":"string"},"content":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.3.content","typeLabel":"string"},"tool_call_id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.3.tool_call_id","typeLabel":"string"}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","const":"developer","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.4.role","typeLabel":"string"},"content":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.4.content","typeLabel":"string"},"name":{"type":"string","uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.4.name","typeLabel":"string"}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"Deprecated. Use ToolMessage instead. Auriko auto-converts function messages to tool messages.","required":["role","content","name"],"deprecated":true,"properties":{"role":{"type":"string","const":"function","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.5.role","typeLabel":"string"},"content":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.5.content.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.5.content.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.5.content","typeLabel":"string | null"},"name":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.5.name","typeLabel":"string"}},"uniqueKey":"oneOf.0.messages.items.[INDEX].oneOf.5","typeLabel":"object"}],"uniqueKey":"oneOf.0.messages.items.[INDEX]","typeLabel":"object"},"minItems":1,"description":"The messages to generate a completion for","isRequired":true,"uniqueKey":"oneOf.0.messages","typeLabel":"object[]"},"temperature":{"type":"number","minimum":0,"maximum":2,"description":"Sampling temperature (0-2). Some providers restrict this value when reasoning is enabled.","uniqueKey":"oneOf.0.temperature","typeLabel":"number"},"top_p":{"type":"number","minimum":0,"maximum":1,"description":"Nucleus sampling parameter. Some providers restrict this value when reasoning is enabled.","uniqueKey":"oneOf.0.top_p","typeLabel":"number"},"max_tokens":{"type":"integer","minimum":1,"description":"Maximum tokens to generate (legacy, use `max_completion_tokens`)","uniqueKey":"oneOf.0.max_tokens","typeLabel":"integer"},"max_completion_tokens":{"type":"integer","minimum":1,"description":"Maximum tokens to generate. Reasoning models (o1/o3) use this field instead of `max_tokens`.","uniqueKey":"oneOf.0.max_completion_tokens","typeLabel":"integer"},"reasoning_effort":{"type":"string","enum":["none","minimal","low","medium","high","xhigh","max","off"],"description":"Controls reasoning effort for supported models. Auriko translates\nthis into each provider's native reasoning control.\n\nSee /guides/extensions-and-thinking for per-provider behavior.\n","uniqueKey":"oneOf.0.reasoning_effort","typeLabel":"enum\u003cstring>"},"reasoning":{"type":"object","description":"Controls reasoning visibility in the response. Set `exclude: true` to omit\nreasoning fields (`reasoning_content`, `reasoning`, and streaming reasoning\ndeltas) from the response. The model still reasons and reasoning tokens are\nbilled; use `reasoning_effort` to control reasoning depth.\n\nKeys other than `exclude` (for example OpenRouter's `effort`) are ignored\nand surfaced as an `unsupported_field` warning in `routing_metadata.warnings`.\n\nSee /guides/extensions-and-thinking for details.\n","properties":{"exclude":{"type":"boolean","default":false,"description":"Omit reasoning fields from the response.","uniqueKey":"oneOf.0.reasoning.exclude","typeLabel":"boolean"}},"uniqueKey":"oneOf.0.reasoning","typeLabel":"object"},"stop":{"oneOf":[{"type":"string","description":"Stop sequences. Restrictions vary by provider and model.","uniqueKey":"oneOf.0.stop.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.stop.oneOf.1.items.[INDEX]","typeLabel":"string"},"description":"Stop sequences. Restrictions vary by provider and model.","maxItems":4,"uniqueKey":"oneOf.0.stop.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"oneOf.0.stop","typeLabel":"string | string[]"},"presence_penalty":{"type":"number","minimum":-2,"maximum":2,"description":"Presence penalty (-2 to 2). Not supported by all providers.","uniqueKey":"oneOf.0.presence_penalty","typeLabel":"number"},"frequency_penalty":{"type":"number","minimum":-2,"maximum":2,"description":"Frequency penalty (-2 to 2). Not supported by all providers.","uniqueKey":"oneOf.0.frequency_penalty","typeLabel":"number"},"logit_bias":{"type":"object","additionalProperties":{"type":"number","uniqueKey":"oneOf.0.logit_bias.additionalProperties","typeLabel":"number"},"description":"Token logit bias. Not supported by all providers.","uniqueKey":"oneOf.0.logit_bias","typeLabel":"object"},"seed":{"type":"integer","description":"Random seed for reproducibility","uniqueKey":"oneOf.0.seed","typeLabel":"integer"},"top_k":{"type":"integer","minimum":1,"description":"Top-K sampling. Restricted by some providers when reasoning is enabled. Supported by Anthropic, Google, and vLLM.","uniqueKey":"oneOf.0.top_k","typeLabel":"integer"},"min_p":{"type":"number","minimum":0,"maximum":1,"description":"Min-P sampling. Supported by some vLLM providers.","uniqueKey":"oneOf.0.min_p","typeLabel":"number"},"top_a":{"type":"number","minimum":0,"maximum":1,"description":"Top-A sampling. Supported by some vLLM providers.","uniqueKey":"oneOf.0.top_a","typeLabel":"number"},"repetition_penalty":{"type":"number","description":"Repetition penalty. Supported by vLLM providers.","uniqueKey":"oneOf.0.repetition_penalty","typeLabel":"number"},"tools":{"type":"array","items":{"type":"object","required":["type","function"],"properties":{"type":{"type":"string","const":"function","isRequired":true,"uniqueKey":"oneOf.0.tools.items.[INDEX].type","typeLabel":"string"},"function":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Function name","isRequired":true,"uniqueKey":"oneOf.0.tools.items.[INDEX].function.name","typeLabel":"string"},"description":{"type":"string","description":"Function description","uniqueKey":"oneOf.0.tools.items.[INDEX].function.description","typeLabel":"string"},"parameters":{"type":"object","description":"JSON Schema for function parameters","additionalProperties":true,"uniqueKey":"oneOf.0.tools.items.[INDEX].function.parameters","typeLabel":"object"},"strict":{"type":"boolean","description":"Enable strict mode for structured outputs","uniqueKey":"oneOf.0.tools.items.[INDEX].function.strict","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"oneOf.0.tools.items.[INDEX].function","typeLabel":"object"}},"uniqueKey":"oneOf.0.tools.items.[INDEX]","typeLabel":"object"},"description":"Tools the model can call","uniqueKey":"oneOf.0.tools","typeLabel":"object[]"},"tool_choice":{"oneOf":[{"type":"string","enum":["auto","required","none"],"uniqueKey":"oneOf.0.tool_choice.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"object","required":["type","function"],"properties":{"type":{"type":"string","const":"function","isRequired":true,"uniqueKey":"oneOf.0.tool_choice.oneOf.1.type","typeLabel":"string"},"function":{"type":"object","required":["name"],"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.tool_choice.oneOf.1.function.name","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.0.tool_choice.oneOf.1.function","typeLabel":"object"}},"uniqueKey":"oneOf.0.tool_choice.oneOf.1","typeLabel":"object"}],"uniqueKey":"oneOf.0.tool_choice","typeLabel":"enum\u003cstring> | object"},"parallel_tool_calls":{"type":"boolean","description":"Allow parallel tool calls","uniqueKey":"oneOf.0.parallel_tool_calls","typeLabel":"boolean"},"functions":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Function name","isRequired":true,"uniqueKey":"oneOf.0.functions.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","description":"Function description","uniqueKey":"oneOf.0.functions.items.[INDEX].description","typeLabel":"string"},"parameters":{"type":"object","description":"JSON Schema for function parameters","additionalProperties":true,"uniqueKey":"oneOf.0.functions.items.[INDEX].parameters","typeLabel":"object"},"strict":{"type":"boolean","description":"Enable strict mode for structured outputs","uniqueKey":"oneOf.0.functions.items.[INDEX].strict","typeLabel":"boolean"}},"uniqueKey":"oneOf.0.functions.items.[INDEX]","typeLabel":"object"},"deprecated":true,"description":"Deprecated. Use `tools` instead. Auto-converted.","uniqueKey":"oneOf.0.functions","typeLabel":"object[]"},"function_call":{"oneOf":[{"type":"string","description":"Deprecated. Use `tool_choice` instead. Auto-converted.","enum":["none","auto"],"deprecated":true,"uniqueKey":"oneOf.0.function_call.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"object","description":"Deprecated. Use `tool_choice` instead. Auto-converted.","required":["name"],"deprecated":true,"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.function_call.oneOf.1.name","typeLabel":"string"}},"uniqueKey":"oneOf.0.function_call.oneOf.1","typeLabel":"object"}],"uniqueKey":"oneOf.0.function_call","typeLabel":"enum\u003cstring> | object"},"response_format":{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["text","json_object","json_schema"],"description":"Response format type:\n- `text`: Plain text response (default)\n- `json_object`: JSON mode - model outputs valid JSON\n- `json_schema`: Structured output - model follows provided schema\n","isRequired":true,"uniqueKey":"oneOf.0.response_format.type","typeLabel":"enum\u003cstring>"},"json_schema":{"type":"object","description":"Required when type is `json_schema`","required":["name","schema"],"properties":{"name":{"type":"string","description":"Schema name (required)","isRequired":true,"uniqueKey":"oneOf.0.response_format.json_schema.name","typeLabel":"string"},"schema":{"type":"object","description":"JSON Schema definition","additionalProperties":true,"isRequired":true,"uniqueKey":"oneOf.0.response_format.json_schema.schema","typeLabel":"object"},"description":{"type":"string","description":"Schema description","uniqueKey":"oneOf.0.response_format.json_schema.description","typeLabel":"string"},"strict":{"type":"boolean","description":"Enable strict schema validation","uniqueKey":"oneOf.0.response_format.json_schema.strict","typeLabel":"boolean"}},"uniqueKey":"oneOf.0.response_format.json_schema","typeLabel":"object"}},"uniqueKey":"oneOf.0.response_format","typeLabel":"object"},"stream":{"type":"boolean","default":false,"description":"Enable streaming responses","uniqueKey":"oneOf.0.stream","typeLabel":"boolean"},"stream_options":{"type":"object","properties":{"include_usage":{"type":"boolean","description":"Include token usage in final streaming chunk","uniqueKey":"oneOf.0.stream_options.include_usage","typeLabel":"boolean"}},"uniqueKey":"oneOf.0.stream_options","typeLabel":"object"},"user":{"type":"string","description":"User identifier for abuse detection","uniqueKey":"oneOf.0.user","typeLabel":"string"},"n":{"type":"integer","minimum":1,"maximum":10,"default":1,"description":"Number of completions to generate. Not supported by all providers.","uniqueKey":"oneOf.0.n","typeLabel":"integer"},"logprobs":{"type":"boolean","description":"Return log probabilities. Not supported by all providers.","uniqueKey":"oneOf.0.logprobs","typeLabel":"boolean"},"top_logprobs":{"type":"integer","minimum":0,"maximum":20,"description":"Number of top logprobs to return. Requires logprobs support.","uniqueKey":"oneOf.0.top_logprobs","typeLabel":"integer"},"web_search_options":{"type":"object","description":"Web search configuration. Supported by OpenAI.","additionalProperties":true,"uniqueKey":"oneOf.0.web_search_options","typeLabel":"object"},"verbosity":{"type":"string","description":"Output verbosity control. Supported by OpenAI.","uniqueKey":"oneOf.0.verbosity","typeLabel":"string"},"prompt_cache_key":{"type":"string","description":"Prompt caching identifier. Supported by OpenAI.","uniqueKey":"oneOf.0.prompt_cache_key","typeLabel":"string"},"safety_identifier":{"type":"string","description":"Safety policy identifier. Supported by OpenAI.","uniqueKey":"oneOf.0.safety_identifier","typeLabel":"string"},"gateway":{"type":"object","description":"Auriko routing, metadata, and multi-model configuration. Omit for default single-model routing.","properties":{"routing":{"type":"object","description":"Auriko routing configuration (20 fields).\n\nControls how Auriko selects providers for your request.\nAll fields are optional. Setting a field to `null` is equivalent to omitting it.\n","properties":{"optimize":{"oneOf":[{"type":"string","enum":["cost","cost-focus","ttft","ttft-focus","tps","tps-focus","balanced",null],"default":"cost-focus","description":"Optimization strategy:\n- `cost`: Minimize cost per token (well-rounded)\n- `cost-focus`: Aggressively minimize cost (default)\n- `ttft`: Minimize time to first token (well-rounded)\n- `ttft-focus`: Aggressively minimize time to first token\n- `tps`: Maximize tokens per second (well-rounded)\n- `tps-focus`: Aggressively maximize tokens per second\n- `balanced`: All dimensions weighted evenly\n","uniqueKey":"oneOf.0.gateway.routing.optimize.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["cost","cost-focus","ttft","ttft-focus","tps","tps-focus","balanced",null],"default":"cost-focus","description":"Optimization strategy:\n- `cost`: Minimize cost per token (well-rounded)\n- `cost-focus`: Aggressively minimize cost (default)\n- `ttft`: Minimize time to first token (well-rounded)\n- `ttft-focus`: Aggressively minimize time to first token\n- `tps`: Maximize tokens per second (well-rounded)\n- `tps-focus`: Aggressively maximize tokens per second\n- `balanced`: All dimensions weighted evenly\n","uniqueKey":"oneOf.0.gateway.routing.optimize.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.optimize","typeLabel":"enum\u003cstring> | null"},"weights":{"oneOf":[{"type":"object","additionalProperties":false,"description":"Custom scoring weights for routing optimization.\nWhen provided, overrides the `optimize` preset coefficients.\nAll values must be non-negative. At least one dimension must be > 0.\nUnspecified dimensions default to 0. Server normalizes to sum to 1.0.\n","properties":{"cost":{"oneOf":[{"type":"number","minimum":0,"description":"Weight for cost minimization.","uniqueKey":"oneOf.0.gateway.routing.weights.oneOf.0.cost.oneOf.0","typeLabel":"number"},{"type":"null","minimum":0,"description":"Weight for cost minimization.","uniqueKey":"oneOf.0.gateway.routing.weights.oneOf.0.cost.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.weights.oneOf.0.cost","typeLabel":"number | null"},"ttft":{"oneOf":[{"type":"number","minimum":0,"description":"Weight for time-to-first-token optimization.","uniqueKey":"oneOf.0.gateway.routing.weights.oneOf.0.ttft.oneOf.0","typeLabel":"number"},{"type":"null","minimum":0,"description":"Weight for time-to-first-token optimization.","uniqueKey":"oneOf.0.gateway.routing.weights.oneOf.0.ttft.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.weights.oneOf.0.ttft","typeLabel":"number | null"},"throughput":{"oneOf":[{"type":"number","minimum":0,"description":"Weight for tokens-per-second optimization.","uniqueKey":"oneOf.0.gateway.routing.weights.oneOf.0.throughput.oneOf.0","typeLabel":"number"},{"type":"null","minimum":0,"description":"Weight for tokens-per-second optimization.","uniqueKey":"oneOf.0.gateway.routing.weights.oneOf.0.throughput.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.weights.oneOf.0.throughput","typeLabel":"number | null"}},"uniqueKey":"oneOf.0.gateway.routing.weights.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"description":"Custom scoring weights for routing optimization.\nWhen provided, overrides the `optimize` preset coefficients.\nAll values must be non-negative. At least one dimension must be > 0.\nUnspecified dimensions default to 0. Server normalizes to sum to 1.0.\n","properties":{"cost":{"oneOf":[{"type":"number","minimum":0,"description":"Weight for cost minimization."},{"type":"null","minimum":0,"description":"Weight for cost minimization."}]},"ttft":{"oneOf":[{"type":"number","minimum":0,"description":"Weight for time-to-first-token optimization."},{"type":"null","minimum":0,"description":"Weight for time-to-first-token optimization."}]},"throughput":{"oneOf":[{"type":"number","minimum":0,"description":"Weight for tokens-per-second optimization."},{"type":"null","minimum":0,"description":"Weight for tokens-per-second optimization."}]}},"uniqueKey":"oneOf.0.gateway.routing.weights.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.weights","typeLabel":"object | null"},"ttft_percentile":{"oneOf":[{"type":"string","enum":["p50","p95",null],"default":"p50","description":"Which percentile to use for TTFT metrics in scoring and constraint filtering.\np50 uses median, p95 uses worst-case. Default: p50.\n","uniqueKey":"oneOf.0.gateway.routing.ttft_percentile.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["p50","p95",null],"default":"p50","description":"Which percentile to use for TTFT metrics in scoring and constraint filtering.\np50 uses median, p95 uses worst-case. Default: p50.\n","uniqueKey":"oneOf.0.gateway.routing.ttft_percentile.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.ttft_percentile","typeLabel":"enum\u003cstring> | null"},"throughput_percentile":{"oneOf":[{"type":"string","enum":["p50","p95",null],"default":"p50","description":"Which percentile to use for throughput metrics in scoring and constraint filtering.\np50 uses median, p95 uses worst-case. Default: p50.\n","uniqueKey":"oneOf.0.gateway.routing.throughput_percentile.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["p50","p95",null],"default":"p50","description":"Which percentile to use for throughput metrics in scoring and constraint filtering.\np50 uses median, p95 uses worst-case. Default: p50.\n","uniqueKey":"oneOf.0.gateway.routing.throughput_percentile.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.throughput_percentile","typeLabel":"enum\u003cstring> | null"},"max_cost_per_1m":{"oneOf":[{"type":"number","exclusiveMinimum":0,"description":"Maximum cost per 1 million tokens (USD).\nProviders exceeding this cost are excluded from selection.\n","uniqueKey":"oneOf.0.gateway.routing.max_cost_per_1m.oneOf.0","typeLabel":"number"},{"type":"null","exclusiveMinimum":0,"description":"Maximum cost per 1 million tokens (USD).\nProviders exceeding this cost are excluded from selection.\n","uniqueKey":"oneOf.0.gateway.routing.max_cost_per_1m.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.max_cost_per_1m","typeLabel":"number | null"},"max_ttft_ms":{"oneOf":[{"type":"integer","exclusiveMinimum":0,"description":"Maximum time to first token in milliseconds.\nProviders with estimated TTFT above this threshold are excluded.\n","uniqueKey":"oneOf.0.gateway.routing.max_ttft_ms.oneOf.0","typeLabel":"integer"},{"type":"null","exclusiveMinimum":0,"description":"Maximum time to first token in milliseconds.\nProviders with estimated TTFT above this threshold are excluded.\n","uniqueKey":"oneOf.0.gateway.routing.max_ttft_ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.max_ttft_ms","typeLabel":"integer | null"},"min_throughput_tps":{"oneOf":[{"type":"number","exclusiveMinimum":0,"description":"Minimum throughput in tokens per second.\nProviders with estimated throughput below this threshold are excluded.\n","uniqueKey":"oneOf.0.gateway.routing.min_throughput_tps.oneOf.0","typeLabel":"number"},{"type":"null","exclusiveMinimum":0,"description":"Minimum throughput in tokens per second.\nProviders with estimated throughput below this threshold are excluded.\n","uniqueKey":"oneOf.0.gateway.routing.min_throughput_tps.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.min_throughput_tps","typeLabel":"number | null"},"providers":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.gateway.routing.providers.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Provider allowlist. Only consider these providers.\n\nExamples: `[\"openai\", \"anthropic\", \"fireworks_ai\"]`\n","uniqueKey":"oneOf.0.gateway.routing.providers.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Provider allowlist. Only consider these providers.\n\nExamples: `[\"openai\", \"anthropic\", \"fireworks_ai\"]`\n","uniqueKey":"oneOf.0.gateway.routing.providers.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.providers","typeLabel":"string[] | null"},"exclude_providers":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.gateway.routing.exclude_providers.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Provider blocklist. Exclude these providers.\n\nExamples: `[\"together_ai\"]`\n","uniqueKey":"oneOf.0.gateway.routing.exclude_providers.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Provider blocklist. Exclude these providers.\n\nExamples: `[\"together_ai\"]`\n","uniqueKey":"oneOf.0.gateway.routing.exclude_providers.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.exclude_providers","typeLabel":"string[] | null"},"prefer":{"oneOf":[{"type":"string","description":"Preference boost for this provider.\nProvider will be selected if it meets constraints.\n","uniqueKey":"oneOf.0.gateway.routing.prefer.oneOf.0","typeLabel":"string"},{"type":"null","description":"Preference boost for this provider.\nProvider will be selected if it meets constraints.\n","uniqueKey":"oneOf.0.gateway.routing.prefer.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.prefer","typeLabel":"string | null"},"mode":{"oneOf":[{"type":"string","enum":["pool","fallback",null],"default":"pool","description":"How to interpret `gateway.models[]` array:\n- `pool` (default): Route to best provider across all models\n- `fallback`: Try models in order until one succeeds\n","uniqueKey":"oneOf.0.gateway.routing.mode.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["pool","fallback",null],"default":"pool","description":"How to interpret `gateway.models[]` array:\n- `pool` (default): Route to best provider across all models\n- `fallback`: Try models in order until one succeeds\n","uniqueKey":"oneOf.0.gateway.routing.mode.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.mode","typeLabel":"enum\u003cstring> | null"},"allow_fallbacks":{"oneOf":[{"type":"boolean","default":true,"description":"Enable automatic fallback to alternative providers on failure","uniqueKey":"oneOf.0.gateway.routing.allow_fallbacks.oneOf.0","typeLabel":"boolean"},{"type":"null","default":true,"description":"Enable automatic fallback to alternative providers on failure","uniqueKey":"oneOf.0.gateway.routing.allow_fallbacks.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.allow_fallbacks","typeLabel":"boolean | null"},"max_fallback_attempts":{"oneOf":[{"type":"integer","minimum":1,"maximum":19,"default":19,"description":"Maximum fallback attempts before giving up (chain length 20 = primary + 19 fallbacks). Range: 1-19.","uniqueKey":"oneOf.0.gateway.routing.max_fallback_attempts.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"maximum":19,"default":19,"description":"Maximum fallback attempts before giving up (chain length 20 = primary + 19 fallbacks). Range: 1-19.","uniqueKey":"oneOf.0.gateway.routing.max_fallback_attempts.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.max_fallback_attempts","typeLabel":"integer | null"},"timeout_ms":{"oneOf":[{"type":"integer","minimum":1,"description":"Per-attempt timeout in milliseconds. For streaming requests: time to first SSE byte. For non-streaming requests: time to complete response. Default: 120000 (120s streaming first-byte), 300000 (5min non-streaming total).\n","uniqueKey":"oneOf.0.gateway.routing.timeout_ms.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"description":"Per-attempt timeout in milliseconds. For streaming requests: time to first SSE byte. For non-streaming requests: time to complete response. Default: 120000 (120s streaming first-byte), 300000 (5min non-streaming total).\n","uniqueKey":"oneOf.0.gateway.routing.timeout_ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.timeout_ms","typeLabel":"integer | null"},"deadline_ms":{"oneOf":[{"type":"integer","minimum":1,"description":"Request deadline in milliseconds. Hard wall-clock cap across all fallback attempts. Must be >= timeout_ms when both are set. Non-streaming requests default to 1080000 (18 minutes); streaming has no default.\n","uniqueKey":"oneOf.0.gateway.routing.deadline_ms.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"description":"Request deadline in milliseconds. Hard wall-clock cap across all fallback attempts. Must be >= timeout_ms when both are set. Non-streaming requests default to 1080000 (18 minutes); streaming has no default.\n","uniqueKey":"oneOf.0.gateway.routing.deadline_ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.deadline_ms","typeLabel":"integer | null"},"data_policy":{"oneOf":[{"type":"string","enum":["none","no_training","zdr",null],"default":"none","description":"Data retention policy requirement:\n- `none`: No restrictions (default)\n- `no_training`: Provider must not use data for training\n- `zdr`: Zero Data Retention (strictest)\n","uniqueKey":"oneOf.0.gateway.routing.data_policy.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["none","no_training","zdr",null],"default":"none","description":"Data retention policy requirement:\n- `none`: No restrictions (default)\n- `no_training`: Provider must not use data for training\n- `zdr`: Zero Data Retention (strictest)\n","uniqueKey":"oneOf.0.gateway.routing.data_policy.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.data_policy","typeLabel":"enum\u003cstring> | null"},"only_byok":{"oneOf":[{"type":"boolean","default":false,"description":"Only use Bring Your Own Key (BYOK) providers.\nMutually exclusive with `only_platform`. Returns 400 if both are set.\n","uniqueKey":"oneOf.0.gateway.routing.only_byok.oneOf.0","typeLabel":"boolean"},{"type":"null","default":false,"description":"Only use Bring Your Own Key (BYOK) providers.\nMutually exclusive with `only_platform`. Returns 400 if both are set.\n","uniqueKey":"oneOf.0.gateway.routing.only_byok.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.only_byok","typeLabel":"boolean | null"},"only_platform":{"oneOf":[{"type":"boolean","default":false,"description":"Only use platform-managed API keys.\nMutually exclusive with `only_byok`. Returns 400 if both are set.\n","uniqueKey":"oneOf.0.gateway.routing.only_platform.oneOf.0","typeLabel":"boolean"},{"type":"null","default":false,"description":"Only use platform-managed API keys.\nMutually exclusive with `only_byok`. Returns 400 if both are set.\n","uniqueKey":"oneOf.0.gateway.routing.only_platform.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.only_platform","typeLabel":"boolean | null"},"require_parameters":{"oneOf":[{"type":"boolean","default":false,"description":"When true, only route to providers whose accepted_params includes\nall optional parameters sent in this request. Default: false.\n","uniqueKey":"oneOf.0.gateway.routing.require_parameters.oneOf.0","typeLabel":"boolean"},{"type":"null","default":false,"description":"When true, only route to providers whose accepted_params includes\nall optional parameters sent in this request. Default: false.\n","uniqueKey":"oneOf.0.gateway.routing.require_parameters.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.require_parameters","typeLabel":"boolean | null"},"tier":{"oneOf":[{"type":"string","description":"Opt in to a pricing tier. Currently supported: `priority` (Anthropic fast mode — 2.5x speed at 6x cost).\nNote: Auriko's \"priority\" tier refers to Anthropic Fast Mode, not Anthropic's separate Priority Tier (committed capacity SLA).\nOmitting this field (default) excludes premium-tier offerings from routing.\n","enum":["priority",null],"uniqueKey":"oneOf.0.gateway.routing.tier.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Opt in to a pricing tier. Currently supported: `priority` (Anthropic fast mode — 2.5x speed at 6x cost).\nNote: Auriko's \"priority\" tier refers to Anthropic Fast Mode, not Anthropic's separate Priority Tier (committed capacity SLA).\nOmitting this field (default) excludes premium-tier offerings from routing.\n","enum":["priority",null],"uniqueKey":"oneOf.0.gateway.routing.tier.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.gateway.routing.tier","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"oneOf.0.gateway.routing","typeLabel":"object"},"metadata":{"type":"object","description":"Optional request metadata for tracking and observability.\nAttached via the `gateway.metadata` field on chat completion requests.\n","properties":{"tags":{"type":"array","items":{"type":"string","maxLength":50,"uniqueKey":"oneOf.0.gateway.metadata.tags.items.[INDEX]","typeLabel":"string"},"maxItems":100,"description":"Tags for categorizing requests (max 100 items, each ≤50 chars)","uniqueKey":"oneOf.0.gateway.metadata.tags","typeLabel":"string[]"},"user_id":{"type":"string","maxLength":255,"description":"Your application's user identifier for per-user analytics","uniqueKey":"oneOf.0.gateway.metadata.user_id","typeLabel":"string"},"trace_id":{"type":"string","maxLength":255,"description":"Distributed tracing identifier to correlate with your observability stack","uniqueKey":"oneOf.0.gateway.metadata.trace_id","typeLabel":"string"},"custom_fields":{"type":"object","maxProperties":10,"additionalProperties":{"type":"string","maxLength":200,"uniqueKey":"oneOf.0.gateway.metadata.custom_fields.additionalProperties","typeLabel":"string"},"description":"Arbitrary key-value pairs (max 10 keys, keys ≤50 chars, values ≤200 chars)\n","uniqueKey":"oneOf.0.gateway.metadata.custom_fields","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"oneOf.0.gateway.metadata","typeLabel":"object"},"models":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.gateway.models.items.[INDEX]","typeLabel":"string"},"minItems":1,"maxItems":10,"description":"Multi-model routing. Mutually exclusive with top-level `model`. Providing both `model` and `gateway.models` returns 400. Models are tried in order per routing mode.\n","uniqueKey":"oneOf.0.gateway.models","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"oneOf.0.gateway","typeLabel":"object"},"extensions":{"type":"object","description":"Auriko extensions for provider-specific passthrough.\n\nFor reasoning control, use the top-level `reasoning_effort` parameter\ninstead of extensions.\n\n## Provider Passthrough\n\nPass provider-specific parameters directly:\n- `anthropic`: Anthropic-specific parameters\n- `openai`: OpenAI-specific parameters\n- `google`: Google/Gemini-specific parameters\n- `deepseek`: DeepSeek-specific parameters\n\nPassthrough parameters are forwarded as-is to the target provider.\n","properties":{"anthropic":{"type":"object","additionalProperties":true,"description":"Anthropic-specific parameters (passed through)","uniqueKey":"oneOf.0.extensions.anthropic","typeLabel":"object"},"openai":{"type":"object","additionalProperties":true,"description":"OpenAI-specific parameters (passed through)","uniqueKey":"oneOf.0.extensions.openai","typeLabel":"object"},"google":{"type":"object","additionalProperties":true,"description":"Google/Gemini-specific parameters (passed through)","uniqueKey":"oneOf.0.extensions.google","typeLabel":"object"},"deepseek":{"type":"object","additionalProperties":true,"description":"DeepSeek-specific parameters (passed through)","uniqueKey":"oneOf.0.extensions.deepseek","typeLabel":"object"}},"additionalProperties":{"type":"object","description":"Other provider-specific passthrough","uniqueKey":"oneOf.0.extensions.additionalProperties","typeLabel":"object"},"not":{"required":["thinking"]},"uniqueKey":"oneOf.0.extensions","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["messages","gateway"],"properties":{"gateway":{"type":"object","description":"Auriko routing, metadata, and multi-model configuration. Omit for default single-model routing.","required":["models"],"properties":{"models":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.1.gateway.models.items.[INDEX]","typeLabel":"string"},"minItems":1,"maxItems":10,"description":"Multi-model routing. Mutually exclusive with top-level `model`. Providing both `model` and `gateway.models` returns 400. Models are tried in order per routing mode.\n","isRequired":true,"uniqueKey":"oneOf.1.gateway.models","typeLabel":"string[]"},"routing":{"type":"object","description":"Auriko routing configuration (20 fields).\n\nControls how Auriko selects providers for your request.\nAll fields are optional. Setting a field to `null` is equivalent to omitting it.\n","properties":{"optimize":{"oneOf":[{"type":"string","enum":["cost","cost-focus","ttft","ttft-focus","tps","tps-focus","balanced",null],"default":"cost-focus","description":"Optimization strategy:\n- `cost`: Minimize cost per token (well-rounded)\n- `cost-focus`: Aggressively minimize cost (default)\n- `ttft`: Minimize time to first token (well-rounded)\n- `ttft-focus`: Aggressively minimize time to first token\n- `tps`: Maximize tokens per second (well-rounded)\n- `tps-focus`: Aggressively maximize tokens per second\n- `balanced`: All dimensions weighted evenly\n","uniqueKey":"oneOf.1.gateway.routing.optimize.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["cost","cost-focus","ttft","ttft-focus","tps","tps-focus","balanced",null],"default":"cost-focus","description":"Optimization strategy:\n- `cost`: Minimize cost per token (well-rounded)\n- `cost-focus`: Aggressively minimize cost (default)\n- `ttft`: Minimize time to first token (well-rounded)\n- `ttft-focus`: Aggressively minimize time to first token\n- `tps`: Maximize tokens per second (well-rounded)\n- `tps-focus`: Aggressively maximize tokens per second\n- `balanced`: All dimensions weighted evenly\n","uniqueKey":"oneOf.1.gateway.routing.optimize.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.optimize","typeLabel":"enum\u003cstring> | null"},"weights":{"oneOf":[{"type":"object","additionalProperties":false,"description":"Custom scoring weights for routing optimization.\nWhen provided, overrides the `optimize` preset coefficients.\nAll values must be non-negative. At least one dimension must be > 0.\nUnspecified dimensions default to 0. Server normalizes to sum to 1.0.\n","properties":{"cost":{"oneOf":[{"type":"number","minimum":0,"description":"Weight for cost minimization.","uniqueKey":"oneOf.1.gateway.routing.weights.oneOf.0.cost.oneOf.0","typeLabel":"number"},{"type":"null","minimum":0,"description":"Weight for cost minimization.","uniqueKey":"oneOf.1.gateway.routing.weights.oneOf.0.cost.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.weights.oneOf.0.cost","typeLabel":"number | null"},"ttft":{"oneOf":[{"type":"number","minimum":0,"description":"Weight for time-to-first-token optimization.","uniqueKey":"oneOf.1.gateway.routing.weights.oneOf.0.ttft.oneOf.0","typeLabel":"number"},{"type":"null","minimum":0,"description":"Weight for time-to-first-token optimization.","uniqueKey":"oneOf.1.gateway.routing.weights.oneOf.0.ttft.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.weights.oneOf.0.ttft","typeLabel":"number | null"},"throughput":{"oneOf":[{"type":"number","minimum":0,"description":"Weight for tokens-per-second optimization.","uniqueKey":"oneOf.1.gateway.routing.weights.oneOf.0.throughput.oneOf.0","typeLabel":"number"},{"type":"null","minimum":0,"description":"Weight for tokens-per-second optimization.","uniqueKey":"oneOf.1.gateway.routing.weights.oneOf.0.throughput.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.weights.oneOf.0.throughput","typeLabel":"number | null"}},"uniqueKey":"oneOf.1.gateway.routing.weights.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"description":"Custom scoring weights for routing optimization.\nWhen provided, overrides the `optimize` preset coefficients.\nAll values must be non-negative. At least one dimension must be > 0.\nUnspecified dimensions default to 0. Server normalizes to sum to 1.0.\n","properties":{"cost":{"oneOf":[{"type":"number","minimum":0,"description":"Weight for cost minimization."},{"type":"null","minimum":0,"description":"Weight for cost minimization."}]},"ttft":{"oneOf":[{"type":"number","minimum":0,"description":"Weight for time-to-first-token optimization."},{"type":"null","minimum":0,"description":"Weight for time-to-first-token optimization."}]},"throughput":{"oneOf":[{"type":"number","minimum":0,"description":"Weight for tokens-per-second optimization."},{"type":"null","minimum":0,"description":"Weight for tokens-per-second optimization."}]}},"uniqueKey":"oneOf.1.gateway.routing.weights.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.weights","typeLabel":"object | null"},"ttft_percentile":{"oneOf":[{"type":"string","enum":["p50","p95",null],"default":"p50","description":"Which percentile to use for TTFT metrics in scoring and constraint filtering.\np50 uses median, p95 uses worst-case. Default: p50.\n","uniqueKey":"oneOf.1.gateway.routing.ttft_percentile.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["p50","p95",null],"default":"p50","description":"Which percentile to use for TTFT metrics in scoring and constraint filtering.\np50 uses median, p95 uses worst-case. Default: p50.\n","uniqueKey":"oneOf.1.gateway.routing.ttft_percentile.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.ttft_percentile","typeLabel":"enum\u003cstring> | null"},"throughput_percentile":{"oneOf":[{"type":"string","enum":["p50","p95",null],"default":"p50","description":"Which percentile to use for throughput metrics in scoring and constraint filtering.\np50 uses median, p95 uses worst-case. Default: p50.\n","uniqueKey":"oneOf.1.gateway.routing.throughput_percentile.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["p50","p95",null],"default":"p50","description":"Which percentile to use for throughput metrics in scoring and constraint filtering.\np50 uses median, p95 uses worst-case. Default: p50.\n","uniqueKey":"oneOf.1.gateway.routing.throughput_percentile.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.throughput_percentile","typeLabel":"enum\u003cstring> | null"},"max_cost_per_1m":{"oneOf":[{"type":"number","exclusiveMinimum":0,"description":"Maximum cost per 1 million tokens (USD).\nProviders exceeding this cost are excluded from selection.\n","uniqueKey":"oneOf.1.gateway.routing.max_cost_per_1m.oneOf.0","typeLabel":"number"},{"type":"null","exclusiveMinimum":0,"description":"Maximum cost per 1 million tokens (USD).\nProviders exceeding this cost are excluded from selection.\n","uniqueKey":"oneOf.1.gateway.routing.max_cost_per_1m.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.max_cost_per_1m","typeLabel":"number | null"},"max_ttft_ms":{"oneOf":[{"type":"integer","exclusiveMinimum":0,"description":"Maximum time to first token in milliseconds.\nProviders with estimated TTFT above this threshold are excluded.\n","uniqueKey":"oneOf.1.gateway.routing.max_ttft_ms.oneOf.0","typeLabel":"integer"},{"type":"null","exclusiveMinimum":0,"description":"Maximum time to first token in milliseconds.\nProviders with estimated TTFT above this threshold are excluded.\n","uniqueKey":"oneOf.1.gateway.routing.max_ttft_ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.max_ttft_ms","typeLabel":"integer | null"},"min_throughput_tps":{"oneOf":[{"type":"number","exclusiveMinimum":0,"description":"Minimum throughput in tokens per second.\nProviders with estimated throughput below this threshold are excluded.\n","uniqueKey":"oneOf.1.gateway.routing.min_throughput_tps.oneOf.0","typeLabel":"number"},{"type":"null","exclusiveMinimum":0,"description":"Minimum throughput in tokens per second.\nProviders with estimated throughput below this threshold are excluded.\n","uniqueKey":"oneOf.1.gateway.routing.min_throughput_tps.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.min_throughput_tps","typeLabel":"number | null"},"providers":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"oneOf.1.gateway.routing.providers.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Provider allowlist. Only consider these providers.\n\nExamples: `[\"openai\", \"anthropic\", \"fireworks_ai\"]`\n","uniqueKey":"oneOf.1.gateway.routing.providers.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Provider allowlist. Only consider these providers.\n\nExamples: `[\"openai\", \"anthropic\", \"fireworks_ai\"]`\n","uniqueKey":"oneOf.1.gateway.routing.providers.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.providers","typeLabel":"string[] | null"},"exclude_providers":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"oneOf.1.gateway.routing.exclude_providers.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Provider blocklist. Exclude these providers.\n\nExamples: `[\"together_ai\"]`\n","uniqueKey":"oneOf.1.gateway.routing.exclude_providers.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Provider blocklist. Exclude these providers.\n\nExamples: `[\"together_ai\"]`\n","uniqueKey":"oneOf.1.gateway.routing.exclude_providers.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.exclude_providers","typeLabel":"string[] | null"},"prefer":{"oneOf":[{"type":"string","description":"Preference boost for this provider.\nProvider will be selected if it meets constraints.\n","uniqueKey":"oneOf.1.gateway.routing.prefer.oneOf.0","typeLabel":"string"},{"type":"null","description":"Preference boost for this provider.\nProvider will be selected if it meets constraints.\n","uniqueKey":"oneOf.1.gateway.routing.prefer.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.prefer","typeLabel":"string | null"},"mode":{"oneOf":[{"type":"string","enum":["pool","fallback",null],"default":"pool","description":"How to interpret `gateway.models[]` array:\n- `pool` (default): Route to best provider across all models\n- `fallback`: Try models in order until one succeeds\n","uniqueKey":"oneOf.1.gateway.routing.mode.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["pool","fallback",null],"default":"pool","description":"How to interpret `gateway.models[]` array:\n- `pool` (default): Route to best provider across all models\n- `fallback`: Try models in order until one succeeds\n","uniqueKey":"oneOf.1.gateway.routing.mode.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.mode","typeLabel":"enum\u003cstring> | null"},"allow_fallbacks":{"oneOf":[{"type":"boolean","default":true,"description":"Enable automatic fallback to alternative providers on failure","uniqueKey":"oneOf.1.gateway.routing.allow_fallbacks.oneOf.0","typeLabel":"boolean"},{"type":"null","default":true,"description":"Enable automatic fallback to alternative providers on failure","uniqueKey":"oneOf.1.gateway.routing.allow_fallbacks.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.allow_fallbacks","typeLabel":"boolean | null"},"max_fallback_attempts":{"oneOf":[{"type":"integer","minimum":1,"maximum":19,"default":19,"description":"Maximum fallback attempts before giving up (chain length 20 = primary + 19 fallbacks). Range: 1-19.","uniqueKey":"oneOf.1.gateway.routing.max_fallback_attempts.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"maximum":19,"default":19,"description":"Maximum fallback attempts before giving up (chain length 20 = primary + 19 fallbacks). Range: 1-19.","uniqueKey":"oneOf.1.gateway.routing.max_fallback_attempts.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.max_fallback_attempts","typeLabel":"integer | null"},"timeout_ms":{"oneOf":[{"type":"integer","minimum":1,"description":"Per-attempt timeout in milliseconds. For streaming requests: time to first SSE byte. For non-streaming requests: time to complete response. Default: 120000 (120s streaming first-byte), 300000 (5min non-streaming total).\n","uniqueKey":"oneOf.1.gateway.routing.timeout_ms.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"description":"Per-attempt timeout in milliseconds. For streaming requests: time to first SSE byte. For non-streaming requests: time to complete response. Default: 120000 (120s streaming first-byte), 300000 (5min non-streaming total).\n","uniqueKey":"oneOf.1.gateway.routing.timeout_ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.timeout_ms","typeLabel":"integer | null"},"deadline_ms":{"oneOf":[{"type":"integer","minimum":1,"description":"Request deadline in milliseconds. Hard wall-clock cap across all fallback attempts. Must be >= timeout_ms when both are set. Non-streaming requests default to 1080000 (18 minutes); streaming has no default.\n","uniqueKey":"oneOf.1.gateway.routing.deadline_ms.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"description":"Request deadline in milliseconds. Hard wall-clock cap across all fallback attempts. Must be >= timeout_ms when both are set. Non-streaming requests default to 1080000 (18 minutes); streaming has no default.\n","uniqueKey":"oneOf.1.gateway.routing.deadline_ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.deadline_ms","typeLabel":"integer | null"},"data_policy":{"oneOf":[{"type":"string","enum":["none","no_training","zdr",null],"default":"none","description":"Data retention policy requirement:\n- `none`: No restrictions (default)\n- `no_training`: Provider must not use data for training\n- `zdr`: Zero Data Retention (strictest)\n","uniqueKey":"oneOf.1.gateway.routing.data_policy.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["none","no_training","zdr",null],"default":"none","description":"Data retention policy requirement:\n- `none`: No restrictions (default)\n- `no_training`: Provider must not use data for training\n- `zdr`: Zero Data Retention (strictest)\n","uniqueKey":"oneOf.1.gateway.routing.data_policy.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.data_policy","typeLabel":"enum\u003cstring> | null"},"only_byok":{"oneOf":[{"type":"boolean","default":false,"description":"Only use Bring Your Own Key (BYOK) providers.\nMutually exclusive with `only_platform`. Returns 400 if both are set.\n","uniqueKey":"oneOf.1.gateway.routing.only_byok.oneOf.0","typeLabel":"boolean"},{"type":"null","default":false,"description":"Only use Bring Your Own Key (BYOK) providers.\nMutually exclusive with `only_platform`. Returns 400 if both are set.\n","uniqueKey":"oneOf.1.gateway.routing.only_byok.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.only_byok","typeLabel":"boolean | null"},"only_platform":{"oneOf":[{"type":"boolean","default":false,"description":"Only use platform-managed API keys.\nMutually exclusive with `only_byok`. Returns 400 if both are set.\n","uniqueKey":"oneOf.1.gateway.routing.only_platform.oneOf.0","typeLabel":"boolean"},{"type":"null","default":false,"description":"Only use platform-managed API keys.\nMutually exclusive with `only_byok`. Returns 400 if both are set.\n","uniqueKey":"oneOf.1.gateway.routing.only_platform.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.only_platform","typeLabel":"boolean | null"},"require_parameters":{"oneOf":[{"type":"boolean","default":false,"description":"When true, only route to providers whose accepted_params includes\nall optional parameters sent in this request. Default: false.\n","uniqueKey":"oneOf.1.gateway.routing.require_parameters.oneOf.0","typeLabel":"boolean"},{"type":"null","default":false,"description":"When true, only route to providers whose accepted_params includes\nall optional parameters sent in this request. Default: false.\n","uniqueKey":"oneOf.1.gateway.routing.require_parameters.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.require_parameters","typeLabel":"boolean | null"},"tier":{"oneOf":[{"type":"string","description":"Opt in to a pricing tier. Currently supported: `priority` (Anthropic fast mode — 2.5x speed at 6x cost).\nNote: Auriko's \"priority\" tier refers to Anthropic Fast Mode, not Anthropic's separate Priority Tier (committed capacity SLA).\nOmitting this field (default) excludes premium-tier offerings from routing.\n","enum":["priority",null],"uniqueKey":"oneOf.1.gateway.routing.tier.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Opt in to a pricing tier. Currently supported: `priority` (Anthropic fast mode — 2.5x speed at 6x cost).\nNote: Auriko's \"priority\" tier refers to Anthropic Fast Mode, not Anthropic's separate Priority Tier (committed capacity SLA).\nOmitting this field (default) excludes premium-tier offerings from routing.\n","enum":["priority",null],"uniqueKey":"oneOf.1.gateway.routing.tier.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.gateway.routing.tier","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"oneOf.1.gateway.routing","typeLabel":"object"},"metadata":{"type":"object","description":"Optional request metadata for tracking and observability.\nAttached via the `gateway.metadata` field on chat completion requests.\n","properties":{"tags":{"type":"array","items":{"type":"string","maxLength":50,"uniqueKey":"oneOf.1.gateway.metadata.tags.items.[INDEX]","typeLabel":"string"},"maxItems":100,"description":"Tags for categorizing requests (max 100 items, each ≤50 chars)","uniqueKey":"oneOf.1.gateway.metadata.tags","typeLabel":"string[]"},"user_id":{"type":"string","maxLength":255,"description":"Your application's user identifier for per-user analytics","uniqueKey":"oneOf.1.gateway.metadata.user_id","typeLabel":"string"},"trace_id":{"type":"string","maxLength":255,"description":"Distributed tracing identifier to correlate with your observability stack","uniqueKey":"oneOf.1.gateway.metadata.trace_id","typeLabel":"string"},"custom_fields":{"type":"object","maxProperties":10,"additionalProperties":{"type":"string","maxLength":200,"uniqueKey":"oneOf.1.gateway.metadata.custom_fields.additionalProperties","typeLabel":"string"},"description":"Arbitrary key-value pairs (max 10 keys, keys ≤50 chars, values ≤200 chars)\n","uniqueKey":"oneOf.1.gateway.metadata.custom_fields","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"oneOf.1.gateway.metadata","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.gateway","typeLabel":"object"},"messages":{"type":"array","items":{"oneOf":[{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","const":"system","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.0.role","typeLabel":"string"},"content":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.0.content.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"object","required":["type","text"],"properties":{"type":{"type":"string","const":"text","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.0.content.oneOf.1.items.[INDEX].type","typeLabel":"string"},"text":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.0.content.oneOf.1.items.[INDEX].text","typeLabel":"string"},"cache_control":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"ephemeral","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.0.content.oneOf.1.items.[INDEX].cache_control.type","typeLabel":"string"}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.0.content.oneOf.1.items.[INDEX].cache_control","typeLabel":"object"}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.0.content.oneOf.1.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.0.content.oneOf.1","typeLabel":"object[]"}],"isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.0.content","typeLabel":"string | object[]"},"name":{"type":"string","uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.0.name","typeLabel":"string"}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","const":"user","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1.role","typeLabel":"string"},"content":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1.content.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"object","required":["type","text"],"properties":{"type":{"type":"string","const":"text","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.0.type","typeLabel":"string"},"text":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.0.text","typeLabel":"string"},"cache_control":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"ephemeral","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.0.cache_control.type","typeLabel":"string"}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.0.cache_control","typeLabel":"object"}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","image_url"],"properties":{"type":{"type":"string","const":"image_url","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.1.type","typeLabel":"string"},"image_url":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.1.image_url.url","typeLabel":"string\u003curi>"},"detail":{"type":"string","enum":["auto","low","high"],"default":"auto","uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.1.image_url.detail","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.1.image_url","typeLabel":"object"},"cache_control":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"ephemeral","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.1.cache_control.type","typeLabel":"string"}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.1.cache_control","typeLabel":"object"}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1.content.oneOf.1.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1.content.oneOf.1","typeLabel":"object[]"}],"isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1.content","typeLabel":"string | object[]"},"name":{"type":"string","uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1.name","typeLabel":"string"}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["role"],"properties":{"role":{"type":"string","const":"assistant","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.role","typeLabel":"string"},"content":{"oneOf":[{"type":"string","uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.content.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.content.oneOf.1","typeLabel":"null"},{"type":"array","items":{"type":"object","required":["type","text"],"properties":{"type":{"type":"string","const":"text","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.content.oneOf.2.items.[INDEX].type","typeLabel":"string"},"text":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.content.oneOf.2.items.[INDEX].text","typeLabel":"string"},"cache_control":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"ephemeral","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.content.oneOf.2.items.[INDEX].cache_control.type","typeLabel":"string"}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.content.oneOf.2.items.[INDEX].cache_control","typeLabel":"object"}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.content.oneOf.2.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.content.oneOf.2","typeLabel":"object[]"}],"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.content","typeLabel":"string | null | object[]"},"name":{"type":"string","uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.name","typeLabel":"string"},"tool_calls":{"oneOf":[{"type":"array","items":{"type":"object","required":["id","type","function"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.tool_calls.oneOf.0.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","const":"function","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.tool_calls.oneOf.0.items.[INDEX].type","typeLabel":"string"},"function":{"type":"object","required":["name","arguments"],"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.tool_calls.oneOf.0.items.[INDEX].function.name","typeLabel":"string"},"arguments":{"type":"string","description":"JSON string of function arguments","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.tool_calls.oneOf.0.items.[INDEX].function.arguments","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.tool_calls.oneOf.0.items.[INDEX].function","typeLabel":"object"},"provider_signature":{"type":"string","description":"Provider-specific cryptographic signature for function-call round-trip.\nEcho back on next request for multi-turn correctness.\n","uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.tool_calls.oneOf.0.items.[INDEX].provider_signature","typeLabel":"string"}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.tool_calls.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.tool_calls.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","required":["id","type","function"],"properties":{"id":{"type":"string"},"type":{"type":"string","const":"function"},"function":{"type":"object","required":["name","arguments"],"properties":{"name":{"type":"string"},"arguments":{"type":"string","description":"JSON string of function arguments"}}},"provider_signature":{"type":"string","description":"Provider-specific cryptographic signature for function-call round-trip.\nEcho back on next request for multi-turn correctness.\n"}}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.tool_calls.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.tool_calls","typeLabel":"object[] | null"},"reasoning":{"oneOf":[{"type":"array","items":{"oneOf":[{"type":"object","description":"Structured reasoning block from thinking models. Discriminated on `type`.\nUsed on both request side (AssistantMessage.reasoning) and response side (Choice.message.reasoning).\n","required":["type","thinking","signature"],"properties":{"type":{"type":"string","const":"thinking","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.reasoning.oneOf.0.items.[INDEX].oneOf.0.type","typeLabel":"string"},"thinking":{"type":"string","description":"The model's reasoning content","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.reasoning.oneOf.0.items.[INDEX].oneOf.0.thinking","typeLabel":"string"},"signature":{"type":"string","description":"Cryptographic signature for multi-turn verification","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.reasoning.oneOf.0.items.[INDEX].oneOf.0.signature","typeLabel":"string"}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.reasoning.oneOf.0.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Structured reasoning block from thinking models. Discriminated on `type`.\nUsed on both request side (AssistantMessage.reasoning) and response side (Choice.message.reasoning).\n","required":["type","data"],"properties":{"type":{"type":"string","const":"redacted","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.reasoning.oneOf.0.items.[INDEX].oneOf.1.type","typeLabel":"string"},"data":{"type":"string","description":"Opaque encrypted reasoning data (pass through verbatim)","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.reasoning.oneOf.0.items.[INDEX].oneOf.1.data","typeLabel":"string"}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.reasoning.oneOf.0.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.reasoning.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Structured reasoning blocks with cryptographic signatures for multi-turn round-trip.\n","uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.reasoning.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"oneOf":[{"type":"object","description":"Structured reasoning block from thinking models. Discriminated on `type`.\nUsed on both request side (AssistantMessage.reasoning) and response side (Choice.message.reasoning).\n","required":["type","thinking","signature"],"properties":{"type":{"type":"string","const":"thinking"},"thinking":{"type":"string","description":"The model's reasoning content"},"signature":{"type":"string","description":"Cryptographic signature for multi-turn verification"}}},{"type":"object","description":"Structured reasoning block from thinking models. Discriminated on `type`.\nUsed on both request side (AssistantMessage.reasoning) and response side (Choice.message.reasoning).\n","required":["type","data"],"properties":{"type":{"type":"string","const":"redacted"},"data":{"type":"string","description":"Opaque encrypted reasoning data (pass through verbatim)"}}}]},"description":"Structured reasoning blocks with cryptographic signatures for multi-turn round-trip.\n","uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.reasoning.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.reasoning","typeLabel":"object[] | null"},"reasoning_content":{"oneOf":[{"type":"string","description":"Reasoning content from the model's previous response. Echo back the value\nfrom the assistant message's reasoning_content field for DeepSeek multi-turn\ntool calling. Other providers accept but ignore this field.\n","uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.reasoning_content.oneOf.0","typeLabel":"string"},{"type":"null","description":"Reasoning content from the model's previous response. Echo back the value\nfrom the assistant message's reasoning_content field for DeepSeek multi-turn\ntool calling. Other providers accept but ignore this field.\n","uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.reasoning_content.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.reasoning_content","typeLabel":"string | null"},"refusal":{"oneOf":[{"type":"string","uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.refusal.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.refusal.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.refusal","typeLabel":"string | null"},"function_call":{"deprecated":true,"type":"object","properties":{"name":{"type":"string","uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.function_call.name","typeLabel":"string"},"arguments":{"type":"string","uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.function_call.arguments","typeLabel":"string"}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2.function_call","typeLabel":"object"}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["role","content","tool_call_id"],"properties":{"role":{"type":"string","const":"tool","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.3.role","typeLabel":"string"},"content":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.3.content","typeLabel":"string"},"tool_call_id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.3.tool_call_id","typeLabel":"string"}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","const":"developer","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.4.role","typeLabel":"string"},"content":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.4.content","typeLabel":"string"},"name":{"type":"string","uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.4.name","typeLabel":"string"}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"Deprecated. Use ToolMessage instead. Auriko auto-converts function messages to tool messages.","required":["role","content","name"],"deprecated":true,"properties":{"role":{"type":"string","const":"function","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.5.role","typeLabel":"string"},"content":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.5.content.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.5.content.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.5.content","typeLabel":"string | null"},"name":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.5.name","typeLabel":"string"}},"uniqueKey":"oneOf.1.messages.items.[INDEX].oneOf.5","typeLabel":"object"}],"uniqueKey":"oneOf.1.messages.items.[INDEX]","typeLabel":"object"},"minItems":1,"description":"The messages to generate a completion for","isRequired":true,"uniqueKey":"oneOf.1.messages","typeLabel":"object[]"},"model":{"type":"string","example":"gpt-4o","description":"Model to route to, required for single-model requests.\nMutually exclusive with `gateway.models`; providing both returns 400.\n\nExamples: `gpt-4o`, `claude-sonnet-4-6`, `llama-3.3-70b-instruct`\n","uniqueKey":"oneOf.1.model","typeLabel":"string"},"temperature":{"type":"number","minimum":0,"maximum":2,"description":"Sampling temperature (0-2). Some providers restrict this value when reasoning is enabled.","uniqueKey":"oneOf.1.temperature","typeLabel":"number"},"top_p":{"type":"number","minimum":0,"maximum":1,"description":"Nucleus sampling parameter. Some providers restrict this value when reasoning is enabled.","uniqueKey":"oneOf.1.top_p","typeLabel":"number"},"max_tokens":{"type":"integer","minimum":1,"description":"Maximum tokens to generate (legacy, use `max_completion_tokens`)","uniqueKey":"oneOf.1.max_tokens","typeLabel":"integer"},"max_completion_tokens":{"type":"integer","minimum":1,"description":"Maximum tokens to generate. Reasoning models (o1/o3) use this field instead of `max_tokens`.","uniqueKey":"oneOf.1.max_completion_tokens","typeLabel":"integer"},"reasoning_effort":{"type":"string","enum":["none","minimal","low","medium","high","xhigh","max","off"],"description":"Controls reasoning effort for supported models. Auriko translates\nthis into each provider's native reasoning control.\n\nSee /guides/extensions-and-thinking for per-provider behavior.\n","uniqueKey":"oneOf.1.reasoning_effort","typeLabel":"enum\u003cstring>"},"reasoning":{"type":"object","description":"Controls reasoning visibility in the response. Set `exclude: true` to omit\nreasoning fields (`reasoning_content`, `reasoning`, and streaming reasoning\ndeltas) from the response. The model still reasons and reasoning tokens are\nbilled; use `reasoning_effort` to control reasoning depth.\n\nKeys other than `exclude` (for example OpenRouter's `effort`) are ignored\nand surfaced as an `unsupported_field` warning in `routing_metadata.warnings`.\n\nSee /guides/extensions-and-thinking for details.\n","properties":{"exclude":{"type":"boolean","default":false,"description":"Omit reasoning fields from the response.","uniqueKey":"oneOf.1.reasoning.exclude","typeLabel":"boolean"}},"uniqueKey":"oneOf.1.reasoning","typeLabel":"object"},"stop":{"oneOf":[{"type":"string","description":"Stop sequences. Restrictions vary by provider and model.","uniqueKey":"oneOf.1.stop.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"oneOf.1.stop.oneOf.1.items.[INDEX]","typeLabel":"string"},"description":"Stop sequences. Restrictions vary by provider and model.","maxItems":4,"uniqueKey":"oneOf.1.stop.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"oneOf.1.stop","typeLabel":"string | string[]"},"presence_penalty":{"type":"number","minimum":-2,"maximum":2,"description":"Presence penalty (-2 to 2). Not supported by all providers.","uniqueKey":"oneOf.1.presence_penalty","typeLabel":"number"},"frequency_penalty":{"type":"number","minimum":-2,"maximum":2,"description":"Frequency penalty (-2 to 2). Not supported by all providers.","uniqueKey":"oneOf.1.frequency_penalty","typeLabel":"number"},"logit_bias":{"type":"object","additionalProperties":{"type":"number","uniqueKey":"oneOf.1.logit_bias.additionalProperties","typeLabel":"number"},"description":"Token logit bias. Not supported by all providers.","uniqueKey":"oneOf.1.logit_bias","typeLabel":"object"},"seed":{"type":"integer","description":"Random seed for reproducibility","uniqueKey":"oneOf.1.seed","typeLabel":"integer"},"top_k":{"type":"integer","minimum":1,"description":"Top-K sampling. Restricted by some providers when reasoning is enabled. Supported by Anthropic, Google, and vLLM.","uniqueKey":"oneOf.1.top_k","typeLabel":"integer"},"min_p":{"type":"number","minimum":0,"maximum":1,"description":"Min-P sampling. Supported by some vLLM providers.","uniqueKey":"oneOf.1.min_p","typeLabel":"number"},"top_a":{"type":"number","minimum":0,"maximum":1,"description":"Top-A sampling. Supported by some vLLM providers.","uniqueKey":"oneOf.1.top_a","typeLabel":"number"},"repetition_penalty":{"type":"number","description":"Repetition penalty. Supported by vLLM providers.","uniqueKey":"oneOf.1.repetition_penalty","typeLabel":"number"},"tools":{"type":"array","items":{"type":"object","required":["type","function"],"properties":{"type":{"type":"string","const":"function","isRequired":true,"uniqueKey":"oneOf.1.tools.items.[INDEX].type","typeLabel":"string"},"function":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Function name","isRequired":true,"uniqueKey":"oneOf.1.tools.items.[INDEX].function.name","typeLabel":"string"},"description":{"type":"string","description":"Function description","uniqueKey":"oneOf.1.tools.items.[INDEX].function.description","typeLabel":"string"},"parameters":{"type":"object","description":"JSON Schema for function parameters","additionalProperties":true,"uniqueKey":"oneOf.1.tools.items.[INDEX].function.parameters","typeLabel":"object"},"strict":{"type":"boolean","description":"Enable strict mode for structured outputs","uniqueKey":"oneOf.1.tools.items.[INDEX].function.strict","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"oneOf.1.tools.items.[INDEX].function","typeLabel":"object"}},"uniqueKey":"oneOf.1.tools.items.[INDEX]","typeLabel":"object"},"description":"Tools the model can call","uniqueKey":"oneOf.1.tools","typeLabel":"object[]"},"tool_choice":{"oneOf":[{"type":"string","enum":["auto","required","none"],"uniqueKey":"oneOf.1.tool_choice.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"object","required":["type","function"],"properties":{"type":{"type":"string","const":"function","isRequired":true,"uniqueKey":"oneOf.1.tool_choice.oneOf.1.type","typeLabel":"string"},"function":{"type":"object","required":["name"],"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.tool_choice.oneOf.1.function.name","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.1.tool_choice.oneOf.1.function","typeLabel":"object"}},"uniqueKey":"oneOf.1.tool_choice.oneOf.1","typeLabel":"object"}],"uniqueKey":"oneOf.1.tool_choice","typeLabel":"enum\u003cstring> | object"},"parallel_tool_calls":{"type":"boolean","description":"Allow parallel tool calls","uniqueKey":"oneOf.1.parallel_tool_calls","typeLabel":"boolean"},"functions":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Function name","isRequired":true,"uniqueKey":"oneOf.1.functions.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","description":"Function description","uniqueKey":"oneOf.1.functions.items.[INDEX].description","typeLabel":"string"},"parameters":{"type":"object","description":"JSON Schema for function parameters","additionalProperties":true,"uniqueKey":"oneOf.1.functions.items.[INDEX].parameters","typeLabel":"object"},"strict":{"type":"boolean","description":"Enable strict mode for structured outputs","uniqueKey":"oneOf.1.functions.items.[INDEX].strict","typeLabel":"boolean"}},"uniqueKey":"oneOf.1.functions.items.[INDEX]","typeLabel":"object"},"deprecated":true,"description":"Deprecated. Use `tools` instead. Auto-converted.","uniqueKey":"oneOf.1.functions","typeLabel":"object[]"},"function_call":{"oneOf":[{"type":"string","description":"Deprecated. Use `tool_choice` instead. Auto-converted.","enum":["none","auto"],"deprecated":true,"uniqueKey":"oneOf.1.function_call.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"object","description":"Deprecated. Use `tool_choice` instead. Auto-converted.","required":["name"],"deprecated":true,"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.function_call.oneOf.1.name","typeLabel":"string"}},"uniqueKey":"oneOf.1.function_call.oneOf.1","typeLabel":"object"}],"uniqueKey":"oneOf.1.function_call","typeLabel":"enum\u003cstring> | object"},"response_format":{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["text","json_object","json_schema"],"description":"Response format type:\n- `text`: Plain text response (default)\n- `json_object`: JSON mode - model outputs valid JSON\n- `json_schema`: Structured output - model follows provided schema\n","isRequired":true,"uniqueKey":"oneOf.1.response_format.type","typeLabel":"enum\u003cstring>"},"json_schema":{"type":"object","description":"Required when type is `json_schema`","required":["name","schema"],"properties":{"name":{"type":"string","description":"Schema name (required)","isRequired":true,"uniqueKey":"oneOf.1.response_format.json_schema.name","typeLabel":"string"},"schema":{"type":"object","description":"JSON Schema definition","additionalProperties":true,"isRequired":true,"uniqueKey":"oneOf.1.response_format.json_schema.schema","typeLabel":"object"},"description":{"type":"string","description":"Schema description","uniqueKey":"oneOf.1.response_format.json_schema.description","typeLabel":"string"},"strict":{"type":"boolean","description":"Enable strict schema validation","uniqueKey":"oneOf.1.response_format.json_schema.strict","typeLabel":"boolean"}},"uniqueKey":"oneOf.1.response_format.json_schema","typeLabel":"object"}},"uniqueKey":"oneOf.1.response_format","typeLabel":"object"},"stream":{"type":"boolean","default":false,"description":"Enable streaming responses","uniqueKey":"oneOf.1.stream","typeLabel":"boolean"},"stream_options":{"type":"object","properties":{"include_usage":{"type":"boolean","description":"Include token usage in final streaming chunk","uniqueKey":"oneOf.1.stream_options.include_usage","typeLabel":"boolean"}},"uniqueKey":"oneOf.1.stream_options","typeLabel":"object"},"user":{"type":"string","description":"User identifier for abuse detection","uniqueKey":"oneOf.1.user","typeLabel":"string"},"n":{"type":"integer","minimum":1,"maximum":10,"default":1,"description":"Number of completions to generate. Not supported by all providers.","uniqueKey":"oneOf.1.n","typeLabel":"integer"},"logprobs":{"type":"boolean","description":"Return log probabilities. Not supported by all providers.","uniqueKey":"oneOf.1.logprobs","typeLabel":"boolean"},"top_logprobs":{"type":"integer","minimum":0,"maximum":20,"description":"Number of top logprobs to return. Requires logprobs support.","uniqueKey":"oneOf.1.top_logprobs","typeLabel":"integer"},"web_search_options":{"type":"object","description":"Web search configuration. Supported by OpenAI.","additionalProperties":true,"uniqueKey":"oneOf.1.web_search_options","typeLabel":"object"},"verbosity":{"type":"string","description":"Output verbosity control. Supported by OpenAI.","uniqueKey":"oneOf.1.verbosity","typeLabel":"string"},"prompt_cache_key":{"type":"string","description":"Prompt caching identifier. Supported by OpenAI.","uniqueKey":"oneOf.1.prompt_cache_key","typeLabel":"string"},"safety_identifier":{"type":"string","description":"Safety policy identifier. Supported by OpenAI.","uniqueKey":"oneOf.1.safety_identifier","typeLabel":"string"},"extensions":{"type":"object","description":"Auriko extensions for provider-specific passthrough.\n\nFor reasoning control, use the top-level `reasoning_effort` parameter\ninstead of extensions.\n\n## Provider Passthrough\n\nPass provider-specific parameters directly:\n- `anthropic`: Anthropic-specific parameters\n- `openai`: OpenAI-specific parameters\n- `google`: Google/Gemini-specific parameters\n- `deepseek`: DeepSeek-specific parameters\n\nPassthrough parameters are forwarded as-is to the target provider.\n","properties":{"anthropic":{"type":"object","additionalProperties":true,"description":"Anthropic-specific parameters (passed through)","uniqueKey":"oneOf.1.extensions.anthropic","typeLabel":"object"},"openai":{"type":"object","additionalProperties":true,"description":"OpenAI-specific parameters (passed through)","uniqueKey":"oneOf.1.extensions.openai","typeLabel":"object"},"google":{"type":"object","additionalProperties":true,"description":"Google/Gemini-specific parameters (passed through)","uniqueKey":"oneOf.1.extensions.google","typeLabel":"object"},"deepseek":{"type":"object","additionalProperties":true,"description":"DeepSeek-specific parameters (passed through)","uniqueKey":"oneOf.1.extensions.deepseek","typeLabel":"object"}},"additionalProperties":{"type":"object","description":"Other provider-specific passthrough","uniqueKey":"oneOf.1.extensions.additionalProperties","typeLabel":"object"},"not":{"required":["thinking"]},"uniqueKey":"oneOf.1.extensions","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"basic":{"title":"basic","summary":"Basic completion","value":{"model":"gpt-4o","messages":[{"role":"user","content":"Hello!"}]}},"with_routing":{"title":"with_routing","summary":"With routing options","value":{"model":"claude-sonnet-4-6","messages":[{"role":"user","content":"Explain quantum computing"}],"gateway":{"routing":{"optimize":"cost","max_cost_per_1m":10}}}},"multi_model":{"title":"multi_model","summary":"Multi-model routing","value":{"gateway":{"models":["gpt-4o","claude-sonnet-4-6"],"routing":{"mode":"pool","optimize":"cost"}},"messages":[{"role":"user","content":"Hello!"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"d5e22c9d-bd82-435f-8da0-11e5f3990cb7":{"description":"Successful completion.\n\nFor streaming (`stream: true`), responses are Server-Sent Events.\nEach event is a `ChatCompletionChunk`. The final chunk has `choices: []`\n(empty) and contains `usage` and `routing_metadata`. Stream ends with\n`data: [DONE]`.\n","headers":{"X-Request-ID":{"description":"Unique request identifier for debugging and support.\nInclude this in support requests for fast resolution.\n","schema":{"type":"string"},"example":"req_abc123def456"},"X-RateLimit-Limit-Requests":{"description":"Request limit per window","schema":{"type":"integer"},"example":60},"X-RateLimit-Remaining-Requests":{"description":"Remaining requests in current window","schema":{"type":"integer"},"example":57},"X-RateLimit-Reset-Requests":{"description":"When the rate limit window resets (ISO 8601)","schema":{"type":"string","format":"date-time"},"example":"2026-06-15T12:01:00.000Z"},"X-Credits-Balance-Microdollars":{"description":"Current workspace credit balance in microdollars (1 USD = 1,000,000)","schema":{"type":"integer"},"example":4850000},"X-Budget-Daily-Spend":{"description":"Daily budget spend in USD (present when daily budget exists)","schema":{"type":"string"},"example":"1.23"},"X-Budget-Daily-Limit":{"description":"Daily budget limit in USD (present when daily budget exists)","schema":{"type":"string"},"example":"10.00"},"X-Budget-Weekly-Spend":{"description":"Weekly budget spend in USD (present when weekly budget exists)","schema":{"type":"string"},"example":"8.50"},"X-Budget-Weekly-Limit":{"description":"Weekly budget limit in USD (present when weekly budget exists)","schema":{"type":"string"},"example":"50.00"},"X-Budget-Monthly-Spend":{"description":"Monthly budget spend in USD (present when monthly budget exists)","schema":{"type":"string"},"example":"35.00"},"X-Budget-Monthly-Limit":{"description":"Monthly budget limit in USD (present when monthly budget exists)","schema":{"type":"string"},"example":"200.00"}},"content":{"application/json":{"schema":{"type":"object","required":["id","object","created","model","choices"],"properties":{"id":{"type":"string","description":"Unique completion identifier","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"object":{"type":"string","const":"chat.completion","isRequired":true,"uniqueKey":"object","typeLabel":"string"},"created":{"type":"integer","description":"Unix timestamp of creation","isRequired":true,"uniqueKey":"created","typeLabel":"integer"},"model":{"type":"string","description":"Model used for completion","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"choices":{"type":"array","items":{"type":"object","required":["index","message","finish_reason"],"properties":{"index":{"type":"integer","description":"Choice index","isRequired":true,"uniqueKey":"choices.items.[INDEX].index","typeLabel":"integer"},"message":{"type":"object","required":["role"],"properties":{"role":{"type":"string","const":"assistant","isRequired":true,"uniqueKey":"choices.items.[INDEX].message.role","typeLabel":"string"},"content":{"oneOf":[{"type":"string","description":"Response content","uniqueKey":"choices.items.[INDEX].message.content.oneOf.0","typeLabel":"string"},{"type":"null","description":"Response content","uniqueKey":"choices.items.[INDEX].message.content.oneOf.1","typeLabel":"null"}],"uniqueKey":"choices.items.[INDEX].message.content","typeLabel":"string | null"},"tool_calls":{"type":"array","items":{"type":"object","required":["id","type","function"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"choices.items.[INDEX].message.tool_calls.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","const":"function","isRequired":true,"uniqueKey":"choices.items.[INDEX].message.tool_calls.items.[INDEX].type","typeLabel":"string"},"function":{"type":"object","required":["name","arguments"],"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"choices.items.[INDEX].message.tool_calls.items.[INDEX].function.name","typeLabel":"string"},"arguments":{"type":"string","description":"JSON string of function arguments","isRequired":true,"uniqueKey":"choices.items.[INDEX].message.tool_calls.items.[INDEX].function.arguments","typeLabel":"string"}},"isRequired":true,"uniqueKey":"choices.items.[INDEX].message.tool_calls.items.[INDEX].function","typeLabel":"object"},"provider_signature":{"type":"string","description":"Provider-specific cryptographic signature for function-call round-trip.\nEcho back on next request for multi-turn correctness.\n","uniqueKey":"choices.items.[INDEX].message.tool_calls.items.[INDEX].provider_signature","typeLabel":"string"}},"uniqueKey":"choices.items.[INDEX].message.tool_calls.items.[INDEX]","typeLabel":"object"},"description":"Tool calls requested by the model","uniqueKey":"choices.items.[INDEX].message.tool_calls","typeLabel":"object[]"},"reasoning_content":{"type":"string","description":"Thinking/reasoning content from reasoning models.\nPresent when using models like o1, DeepSeek R1, or Claude with thinking.\n","uniqueKey":"choices.items.[INDEX].message.reasoning_content","typeLabel":"string"},"reasoning":{"type":"array","items":{"oneOf":[{"type":"object","description":"Structured reasoning block from thinking models. Discriminated on `type`.\nUsed on both request side (AssistantMessage.reasoning) and response side (Choice.message.reasoning).\n","required":["type","thinking","signature"],"properties":{"type":{"type":"string","const":"thinking","isRequired":true,"uniqueKey":"choices.items.[INDEX].message.reasoning.items.[INDEX].oneOf.0.type","typeLabel":"string"},"thinking":{"type":"string","description":"The model's reasoning content","isRequired":true,"uniqueKey":"choices.items.[INDEX].message.reasoning.items.[INDEX].oneOf.0.thinking","typeLabel":"string"},"signature":{"type":"string","description":"Cryptographic signature for multi-turn verification","isRequired":true,"uniqueKey":"choices.items.[INDEX].message.reasoning.items.[INDEX].oneOf.0.signature","typeLabel":"string"}},"uniqueKey":"choices.items.[INDEX].message.reasoning.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Structured reasoning block from thinking models. Discriminated on `type`.\nUsed on both request side (AssistantMessage.reasoning) and response side (Choice.message.reasoning).\n","required":["type","data"],"properties":{"type":{"type":"string","const":"redacted","isRequired":true,"uniqueKey":"choices.items.[INDEX].message.reasoning.items.[INDEX].oneOf.1.type","typeLabel":"string"},"data":{"type":"string","description":"Opaque encrypted reasoning data (pass through verbatim)","isRequired":true,"uniqueKey":"choices.items.[INDEX].message.reasoning.items.[INDEX].oneOf.1.data","typeLabel":"string"}},"uniqueKey":"choices.items.[INDEX].message.reasoning.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"choices.items.[INDEX].message.reasoning.items.[INDEX]","typeLabel":"object"},"description":"Structured reasoning blocks with cryptographic signatures.\nPresent alongside reasoning_content for models that support signed thinking.\n","uniqueKey":"choices.items.[INDEX].message.reasoning","typeLabel":"object[]"},"refusal":{"oneOf":[{"type":"string","description":"Refusal message if the model declined to answer. Present for OpenAI-routed models.","uniqueKey":"choices.items.[INDEX].message.refusal.oneOf.0","typeLabel":"string"},{"type":"null","description":"Refusal message if the model declined to answer. Present for OpenAI-routed models.","uniqueKey":"choices.items.[INDEX].message.refusal.oneOf.1","typeLabel":"null"}],"uniqueKey":"choices.items.[INDEX].message.refusal","typeLabel":"string | null"},"images":{"type":"array","items":{"type":"object","required":["type","mime_type","data"],"properties":{"type":{"type":"string","const":"image","isRequired":true,"uniqueKey":"choices.items.[INDEX].message.images.items.[INDEX].type","typeLabel":"string"},"mime_type":{"type":"string","description":"MIME type of the image (e.g., image/png)","isRequired":true,"uniqueKey":"choices.items.[INDEX].message.images.items.[INDEX].mime_type","typeLabel":"string"},"data":{"type":"string","description":"Base64-encoded image data","isRequired":true,"uniqueKey":"choices.items.[INDEX].message.images.items.[INDEX].data","typeLabel":"string"},"thought_signature":{"type":"string","description":"Opaque model signature for multi-turn image editing. Response-only; request-side round-trip is not yet supported.","uniqueKey":"choices.items.[INDEX].message.images.items.[INDEX].thought_signature","typeLabel":"string"}},"uniqueKey":"choices.items.[INDEX].message.images.items.[INDEX]","typeLabel":"object"},"description":"Generated images from image-capable models. Present when the model produces image output (e.g., Gemini image models). Absent (not null, not empty array) when no images are generated.","uniqueKey":"choices.items.[INDEX].message.images","typeLabel":"object[]"},"annotations":{"type":"array","items":{"oneOf":[{}],"uniqueKey":"choices.items.[INDEX].message.annotations.items.[INDEX]","typeLabel":"any"},"description":"Model annotations such as URL citations. Present for OpenAI-routed models.","uniqueKey":"choices.items.[INDEX].message.annotations","typeLabel":"any[]"}},"isRequired":true,"uniqueKey":"choices.items.[INDEX].message","typeLabel":"object"},"finish_reason":{"oneOf":[{"type":"string","enum":["stop","length","tool_calls","content_filter",null],"description":"Reason generation stopped:\n- `stop`: Natural stop or stop sequence\n- `length`: Max tokens reached\n- `tool_calls`: Model requested tool call\n- `content_filter`: Content was filtered\n- `null`: Generation still in progress (streaming)\n","isRequired":true,"uniqueKey":"choices.items.[INDEX].finish_reason.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["stop","length","tool_calls","content_filter",null],"description":"Reason generation stopped:\n- `stop`: Natural stop or stop sequence\n- `length`: Max tokens reached\n- `tool_calls`: Model requested tool call\n- `content_filter`: Content was filtered\n- `null`: Generation still in progress (streaming)\n","isRequired":true,"uniqueKey":"choices.items.[INDEX].finish_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"choices.items.[INDEX].finish_reason","typeLabel":"enum\u003cstring> | null"},"native_finish_reason":{"oneOf":[{"type":"string","description":"The upstream provider's original finish reason before normalization. Present when the provider uses a different vocabulary (e.g., Anthropic 'end_turn', Google 'STOP').\n","uniqueKey":"choices.items.[INDEX].native_finish_reason.oneOf.0","typeLabel":"string"},{"type":"null","description":"The upstream provider's original finish reason before normalization. Present when the provider uses a different vocabulary (e.g., Anthropic 'end_turn', Google 'STOP').\n","uniqueKey":"choices.items.[INDEX].native_finish_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"choices.items.[INDEX].native_finish_reason","typeLabel":"string | null"},"logprobs":{"oneOf":[{"type":"object","description":"Log probability information","uniqueKey":"choices.items.[INDEX].logprobs.oneOf.0","typeLabel":"object"},{"type":"null","description":"Log probability information","uniqueKey":"choices.items.[INDEX].logprobs.oneOf.1","typeLabel":"null"}],"uniqueKey":"choices.items.[INDEX].logprobs","typeLabel":"object | null"}},"uniqueKey":"choices.items.[INDEX]","typeLabel":"object"},"description":"Completion choices","isRequired":true,"uniqueKey":"choices","typeLabel":"object[]"},"usage":{"type":"object","required":["prompt_tokens","completion_tokens","total_tokens"],"properties":{"prompt_tokens":{"type":"integer","description":"Input tokens used","isRequired":true,"uniqueKey":"usage.prompt_tokens","typeLabel":"integer"},"completion_tokens":{"type":"integer","description":"Output tokens generated","isRequired":true,"uniqueKey":"usage.completion_tokens","typeLabel":"integer"},"total_tokens":{"type":"integer","description":"Total tokens (prompt + completion)","isRequired":true,"uniqueKey":"usage.total_tokens","typeLabel":"integer"},"prompt_tokens_details":{"type":"object","description":"Detailed breakdown of prompt tokens","properties":{"cached_tokens":{"type":"integer","description":"Tokens served from cache","uniqueKey":"usage.prompt_tokens_details.cached_tokens","typeLabel":"integer"},"cache_write_tokens":{"type":"integer","description":"Tokens written to prompt cache. Provider-dependent: present when the upstream provider reports cache write details, absent otherwise.","uniqueKey":"usage.prompt_tokens_details.cache_write_tokens","typeLabel":"integer"}},"uniqueKey":"usage.prompt_tokens_details","typeLabel":"object"},"completion_tokens_details":{"type":"object","description":"Breakdown of completion tokens. Provider-dependent: present when the upstream provider reports token-level details, absent otherwise.","properties":{"reasoning_tokens":{"type":"integer","description":"Thinking/reasoning tokens consumed. Present when the upstream provider reports this count.","uniqueKey":"usage.completion_tokens_details.reasoning_tokens","typeLabel":"integer"},"accepted_prediction_tokens":{"type":"integer","description":"Tokens accepted from a predicted output. Present for OpenAI-routed models that support predicted outputs.","uniqueKey":"usage.completion_tokens_details.accepted_prediction_tokens","typeLabel":"integer"},"rejected_prediction_tokens":{"type":"integer","description":"Tokens rejected from a predicted output. Present for OpenAI-routed models that support predicted outputs.","uniqueKey":"usage.completion_tokens_details.rejected_prediction_tokens","typeLabel":"integer"},"image_tokens":{"type":"integer","description":"Tokens consumed by generated images. Present when the upstream provider reports image token counts (e.g., Gemini image models).","uniqueKey":"usage.completion_tokens_details.image_tokens","typeLabel":"integer"}},"uniqueKey":"usage.completion_tokens_details","typeLabel":"object"}},"description":"Token usage statistics. Present in virtually all responses.\nMay be absent in rare cases where upstream provider does not report usage.\n","uniqueKey":"usage","typeLabel":"object"},"system_fingerprint":{"type":"string","description":"Backend fingerprint for reproducibility. Not all models include this field.","uniqueKey":"system_fingerprint","typeLabel":"string"},"routing_metadata":{"type":"object","description":"Routing decision metadata included in successful responses.\n8 STABLE fields (4 required + 4 optional) in the current public contract.\n","required":["provider","provider_model_id","model_canonical","routing_strategy"],"properties":{"provider":{"type":"string","description":"Provider name (e.g., \"fireworks_ai\", \"anthropic\")","isRequired":true,"uniqueKey":"routing_metadata.provider","typeLabel":"string"},"provider_model_id":{"type":"string","description":"Provider's model ID","isRequired":true,"uniqueKey":"routing_metadata.provider_model_id","typeLabel":"string"},"model_canonical":{"type":"string","description":"Canonical model ID requested","isRequired":true,"uniqueKey":"routing_metadata.model_canonical","typeLabel":"string"},"routing_strategy":{"type":"string","description":"Strategy used for routing. Known values:\n`cost`, `cost-focus`, `ttft`, `ttft-focus`, `tps`, `tps-focus`, `balanced`, `custom`.\n`custom` is returned when explicit `routing.weights` are provided.\nAdditional strategies may be added in future versions.\n","isRequired":true,"uniqueKey":"routing_metadata.routing_strategy","typeLabel":"string"},"ttft_ms":{"type":"number","description":"Time to first token (streaming only)","uniqueKey":"routing_metadata.ttft_ms","typeLabel":"number"},"throughput_tps":{"type":"number","description":"Output throughput (tokens per second)","uniqueKey":"routing_metadata.throughput_tps","typeLabel":"number"},"cost":{"type":"object","description":"Cost for the request","required":["usd"],"properties":{"usd":{"type":"number","description":"Billable cost in USD","isRequired":true,"uniqueKey":"routing_metadata.cost.usd","typeLabel":"number"},"cache_savings_percent":{"type":"integer","description":"Cache savings as integer percentage (0-100). Present only when savings > 0.","uniqueKey":"routing_metadata.cost.cache_savings_percent","typeLabel":"integer"},"cache_savings_usd":{"type":"number","description":"Cache savings in USD. Present only when savings > 0.","uniqueKey":"routing_metadata.cost.cache_savings_usd","typeLabel":"number"},"hosted_tool_usd":{"type":"number","description":"Hosted tool cost in USD (e.g., web search, code interpreter, image generation). Present only when hosted tools were used.","uniqueKey":"routing_metadata.cost.hosted_tool_usd","typeLabel":"number"}},"uniqueKey":"routing_metadata.cost","typeLabel":"object"},"warnings":{"type":"array","items":{"type":"object","description":"Structured warning emitted in routing_metadata.warnings when the\ngateway modifies or ignores part of the request.\n","required":["type","code","message"],"properties":{"type":{"type":"string","enum":["unsupported_parameter","unsupported_feature","unsupported_field","ignored_extension","unknown_provider","blocked_field","provider_timeout"],"description":"Warning category","isRequired":true,"uniqueKey":"routing_metadata.warnings.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Concrete identifier (parameter name, feature name, provider name, or field name)","isRequired":true,"uniqueKey":"routing_metadata.warnings.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation","isRequired":true,"uniqueKey":"routing_metadata.warnings.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"routing_metadata.warnings.items.[INDEX]","typeLabel":"object"},"description":"Structured warnings emitted when the gateway modifies or ignores\npart of the request (e.g., unsupported parameters, blocked fields).\n","uniqueKey":"routing_metadata.warnings","typeLabel":"object[]"}},"uniqueKey":"routing_metadata","typeLabel":"object"},"service_tier":{"oneOf":[{"type":"string","description":"The service tier used for processing the request. Present for OpenAI-routed models.","uniqueKey":"service_tier.oneOf.0","typeLabel":"string"},{"type":"null","description":"The service tier used for processing the request. Present for OpenAI-routed models.","uniqueKey":"service_tier.oneOf.1","typeLabel":"null"}],"uniqueKey":"service_tier","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"example":{"id":"chatcmpl-abc123","object":"chat.completion","created":1745100000,"model":"gpt-4o-2024-08-06","choices":[{"index":0,"message":{"role":"assistant","content":"The capital of France is Paris."},"logprobs":null,"finish_reason":"stop"}],"usage":{"prompt_tokens":14,"completion_tokens":7,"total_tokens":21,"prompt_tokens_details":{"cached_tokens":0},"completion_tokens_details":{"reasoning_tokens":0}},"system_fingerprint":"fp_d08c293973","routing_metadata":{"provider":"openai","provider_model_id":"gpt-4o-2024-08-06","model_canonical":"gpt-4o","routing_strategy":"cost-focus","throughput_tps":9.2,"cost":{"usd":0.000105}}},"examples":{"Example":{"title":"Example","value":{"id":"chatcmpl-abc123","object":"chat.completion","created":1745100000,"model":"gpt-4o-2024-08-06","choices":[{"index":0,"message":{"role":"assistant","content":"The capital of France is Paris."},"logprobs":null,"finish_reason":"stop"}],"usage":{"prompt_tokens":14,"completion_tokens":7,"total_tokens":21,"prompt_tokens_details":{"cached_tokens":0},"completion_tokens_details":{"reasoning_tokens":0}},"system_fingerprint":"fp_d08c293973","routing_metadata":{"provider":"openai","provider_model_id":"gpt-4o-2024-08-06","model_canonical":"gpt-4o","routing_strategy":"cost-focus","throughput_tps":9.2,"cost":{"usd":0.000105}}}}},"exampleType":"examples"},"text/event-stream":{"schema":{"type":"object","description":"Server-Sent Event wrapper for chat completion streaming.\n\nPer SSE specification, events can have four fields: `id`, `event`, `data`, `retry`.\nOpenAI's streaming format uses only the `data` field, containing the chunk JSON.\n\nExample SSE line from the API:\n```\ndata: {\"id\":\"chatcmpl-xxx\",\"object\":\"chat.completion.chunk\",...}\n```\n","required":["data"],"properties":{"data":{"type":"object","description":"Streaming chunk content (the `data` field payload in SSE).\n\n## Final Chunk Format\n\nThe final chunk has `choices: []` (empty array) and contains:\n- `usage`: Token counts (if `stream_options.include_usage: true`)\n- `routing_metadata`: Routing decision details\n\nThis uses standard `chat.completion.chunk` format for SDK compatibility.\n","required":["id","object","created","model","choices"],"properties":{"id":{"type":"string","description":"Completion identifier (consistent across chunks)","isRequired":true,"uniqueKey":"data.id","typeLabel":"string"},"object":{"type":"string","const":"chat.completion.chunk","isRequired":true,"uniqueKey":"data.object","typeLabel":"string"},"created":{"type":"integer","description":"Unix timestamp of when the chunk was created","isRequired":true,"uniqueKey":"data.created","typeLabel":"integer"},"model":{"type":"string","description":"Model that generated the chunk","isRequired":true,"uniqueKey":"data.model","typeLabel":"string"},"choices":{"type":"array","items":{"type":"object","required":["index","delta","finish_reason"],"properties":{"index":{"type":"integer","description":"Choice index","isRequired":true,"uniqueKey":"data.choices.items.[INDEX].index","typeLabel":"integer"},"delta":{"type":"object","description":"Incremental content delta","properties":{"role":{"type":"string","enum":["assistant"],"uniqueKey":"data.choices.items.[INDEX].delta.role","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"Content fragment","uniqueKey":"data.choices.items.[INDEX].delta.content","typeLabel":"string"},"tool_calls":{"type":"array","items":{"type":"object","description":"Partial tool call for streaming","required":["index"],"properties":{"index":{"type":"integer","description":"Tool call index in the array","isRequired":true,"uniqueKey":"data.choices.items.[INDEX].delta.tool_calls.items.[INDEX].index","typeLabel":"integer"},"id":{"type":"string","uniqueKey":"data.choices.items.[INDEX].delta.tool_calls.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","const":"function","uniqueKey":"data.choices.items.[INDEX].delta.tool_calls.items.[INDEX].type","typeLabel":"string"},"function":{"type":"object","properties":{"name":{"type":"string","uniqueKey":"data.choices.items.[INDEX].delta.tool_calls.items.[INDEX].function.name","typeLabel":"string"},"arguments":{"type":"string","uniqueKey":"data.choices.items.[INDEX].delta.tool_calls.items.[INDEX].function.arguments","typeLabel":"string"}},"uniqueKey":"data.choices.items.[INDEX].delta.tool_calls.items.[INDEX].function","typeLabel":"object"},"provider_signature":{"type":"string","description":"Provider-specific signature for tool call verification (streaming)","uniqueKey":"data.choices.items.[INDEX].delta.tool_calls.items.[INDEX].provider_signature","typeLabel":"string"}},"uniqueKey":"data.choices.items.[INDEX].delta.tool_calls.items.[INDEX]","typeLabel":"object"},"description":"Tool call fragments","uniqueKey":"data.choices.items.[INDEX].delta.tool_calls","typeLabel":"object[]"},"reasoning_content":{"type":"string","description":"Reasoning content fragment","uniqueKey":"data.choices.items.[INDEX].delta.reasoning_content","typeLabel":"string"},"reasoning_signature":{"type":"string","description":"Cryptographic signature for the current thinking block","uniqueKey":"data.choices.items.[INDEX].delta.reasoning_signature","typeLabel":"string"},"reasoning_redacted_data":{"type":"string","description":"Encrypted data for a redacted thinking block (complete in one event)","uniqueKey":"data.choices.items.[INDEX].delta.reasoning_redacted_data","typeLabel":"string"},"refusal":{"oneOf":[{"type":"string","description":"Refusal content fragment","uniqueKey":"data.choices.items.[INDEX].delta.refusal.oneOf.0","typeLabel":"string"},{"type":"null","description":"Refusal content fragment","uniqueKey":"data.choices.items.[INDEX].delta.refusal.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.choices.items.[INDEX].delta.refusal","typeLabel":"string | null"},"images":{"type":"array","items":{"type":"object","required":["type","mime_type","data"],"properties":{"type":{"type":"string","const":"image","isRequired":true,"uniqueKey":"data.choices.items.[INDEX].delta.images.items.[INDEX].type","typeLabel":"string"},"mime_type":{"type":"string","description":"MIME type of the image (e.g., image/png)","isRequired":true,"uniqueKey":"data.choices.items.[INDEX].delta.images.items.[INDEX].mime_type","typeLabel":"string"},"data":{"type":"string","description":"Base64-encoded image data","isRequired":true,"uniqueKey":"data.choices.items.[INDEX].delta.images.items.[INDEX].data","typeLabel":"string"},"thought_signature":{"type":"string","description":"Opaque model signature for multi-turn image editing. Response-only; request-side round-trip is not yet supported.","uniqueKey":"data.choices.items.[INDEX].delta.images.items.[INDEX].thought_signature","typeLabel":"string"}},"uniqueKey":"data.choices.items.[INDEX].delta.images.items.[INDEX]","typeLabel":"object"},"description":"Generated images in this streaming chunk. Each image is complete (no partial accumulation needed across chunks).","uniqueKey":"data.choices.items.[INDEX].delta.images","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"data.choices.items.[INDEX].delta","typeLabel":"object"},"finish_reason":{"oneOf":[{"type":"string","enum":["stop","length","tool_calls","content_filter",null],"description":"Null until generation completes","isRequired":true,"uniqueKey":"data.choices.items.[INDEX].finish_reason.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["stop","length","tool_calls","content_filter",null],"description":"Null until generation completes","isRequired":true,"uniqueKey":"data.choices.items.[INDEX].finish_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.choices.items.[INDEX].finish_reason","typeLabel":"enum\u003cstring> | null"},"native_finish_reason":{"oneOf":[{"type":"string","description":"The upstream provider's original finish reason before normalization. Present when the provider uses a different vocabulary (e.g., Anthropic 'end_turn', Google 'STOP').\n","uniqueKey":"data.choices.items.[INDEX].native_finish_reason.oneOf.0","typeLabel":"string"},{"type":"null","description":"The upstream provider's original finish reason before normalization. Present when the provider uses a different vocabulary (e.g., Anthropic 'end_turn', Google 'STOP').\n","uniqueKey":"data.choices.items.[INDEX].native_finish_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.choices.items.[INDEX].native_finish_reason","typeLabel":"string | null"},"logprobs":{"oneOf":[{"type":"object","uniqueKey":"data.choices.items.[INDEX].logprobs.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.choices.items.[INDEX].logprobs.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.choices.items.[INDEX].logprobs","typeLabel":"object | null"}},"uniqueKey":"data.choices.items.[INDEX]","typeLabel":"object"},"description":"Streaming choices. Empty array in final metadata chunk.\n","isRequired":true,"uniqueKey":"data.choices","typeLabel":"object[]"},"usage":{"type":"object","required":["prompt_tokens","completion_tokens","total_tokens"],"properties":{"prompt_tokens":{"type":"integer","description":"Input tokens used","isRequired":true,"uniqueKey":"data.usage.prompt_tokens","typeLabel":"integer"},"completion_tokens":{"type":"integer","description":"Output tokens generated","isRequired":true,"uniqueKey":"data.usage.completion_tokens","typeLabel":"integer"},"total_tokens":{"type":"integer","description":"Total tokens (prompt + completion)","isRequired":true,"uniqueKey":"data.usage.total_tokens","typeLabel":"integer"},"prompt_tokens_details":{"type":"object","description":"Detailed breakdown of prompt tokens","properties":{"cached_tokens":{"type":"integer","description":"Tokens served from cache","uniqueKey":"data.usage.prompt_tokens_details.cached_tokens","typeLabel":"integer"},"cache_write_tokens":{"type":"integer","description":"Tokens written to prompt cache. Provider-dependent: present when the upstream provider reports cache write details, absent otherwise.","uniqueKey":"data.usage.prompt_tokens_details.cache_write_tokens","typeLabel":"integer"}},"uniqueKey":"data.usage.prompt_tokens_details","typeLabel":"object"},"completion_tokens_details":{"type":"object","description":"Breakdown of completion tokens. Provider-dependent: present when the upstream provider reports token-level details, absent otherwise.","properties":{"reasoning_tokens":{"type":"integer","description":"Thinking/reasoning tokens consumed. Present when the upstream provider reports this count.","uniqueKey":"data.usage.completion_tokens_details.reasoning_tokens","typeLabel":"integer"},"accepted_prediction_tokens":{"type":"integer","description":"Tokens accepted from a predicted output. Present for OpenAI-routed models that support predicted outputs.","uniqueKey":"data.usage.completion_tokens_details.accepted_prediction_tokens","typeLabel":"integer"},"rejected_prediction_tokens":{"type":"integer","description":"Tokens rejected from a predicted output. Present for OpenAI-routed models that support predicted outputs.","uniqueKey":"data.usage.completion_tokens_details.rejected_prediction_tokens","typeLabel":"integer"},"image_tokens":{"type":"integer","description":"Tokens consumed by generated images. Present when the upstream provider reports image token counts (e.g., Gemini image models).","uniqueKey":"data.usage.completion_tokens_details.image_tokens","typeLabel":"integer"}},"uniqueKey":"data.usage.completion_tokens_details","typeLabel":"object"}},"description":"Token usage. Only present in final chunk when\n`stream_options.include_usage: true` was set.\n","uniqueKey":"data.usage","typeLabel":"object"},"system_fingerprint":{"type":"string","description":"Backend fingerprint for reproducibility. Not all models include this field.","uniqueKey":"data.system_fingerprint","typeLabel":"string"},"routing_metadata":{"type":"object","description":"Auriko extension. Included in final chunk (when choices is empty).\nContains routing decision transparency data.\n","required":["provider","provider_model_id","model_canonical","routing_strategy"],"properties":{"provider":{"type":"string","description":"Provider name (e.g., \"fireworks_ai\", \"anthropic\")","isRequired":true,"uniqueKey":"data.routing_metadata.provider","typeLabel":"string"},"provider_model_id":{"type":"string","description":"Provider's model ID","isRequired":true,"uniqueKey":"data.routing_metadata.provider_model_id","typeLabel":"string"},"model_canonical":{"type":"string","description":"Canonical model ID requested","isRequired":true,"uniqueKey":"data.routing_metadata.model_canonical","typeLabel":"string"},"routing_strategy":{"type":"string","description":"Strategy used for routing. Known values:\n`cost`, `cost-focus`, `ttft`, `ttft-focus`, `tps`, `tps-focus`, `balanced`, `custom`.\n`custom` is returned when explicit `routing.weights` are provided.\nAdditional strategies may be added in future versions.\n","isRequired":true,"uniqueKey":"data.routing_metadata.routing_strategy","typeLabel":"string"},"ttft_ms":{"type":"number","description":"Time to first token (streaming only)","uniqueKey":"data.routing_metadata.ttft_ms","typeLabel":"number"},"throughput_tps":{"type":"number","description":"Output throughput (tokens per second)","uniqueKey":"data.routing_metadata.throughput_tps","typeLabel":"number"},"cost":{"type":"object","description":"Cost for the request","required":["usd"],"properties":{"usd":{"type":"number","description":"Billable cost in USD","isRequired":true,"uniqueKey":"data.routing_metadata.cost.usd","typeLabel":"number"},"cache_savings_percent":{"type":"integer","description":"Cache savings as integer percentage (0-100). Present only when savings > 0.","uniqueKey":"data.routing_metadata.cost.cache_savings_percent","typeLabel":"integer"},"cache_savings_usd":{"type":"number","description":"Cache savings in USD. Present only when savings > 0.","uniqueKey":"data.routing_metadata.cost.cache_savings_usd","typeLabel":"number"},"hosted_tool_usd":{"type":"number","description":"Hosted tool cost in USD (e.g., web search, code interpreter, image generation). Present only when hosted tools were used.","uniqueKey":"data.routing_metadata.cost.hosted_tool_usd","typeLabel":"number"}},"uniqueKey":"data.routing_metadata.cost","typeLabel":"object"},"warnings":{"type":"array","items":{"type":"object","description":"Structured warning emitted in routing_metadata.warnings when the\ngateway modifies or ignores part of the request.\n","required":["type","code","message"],"properties":{"type":{"type":"string","enum":["unsupported_parameter","unsupported_feature","unsupported_field","ignored_extension","unknown_provider","blocked_field","provider_timeout"],"description":"Warning category","isRequired":true,"uniqueKey":"data.routing_metadata.warnings.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Concrete identifier (parameter name, feature name, provider name, or field name)","isRequired":true,"uniqueKey":"data.routing_metadata.warnings.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation","isRequired":true,"uniqueKey":"data.routing_metadata.warnings.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"data.routing_metadata.warnings.items.[INDEX]","typeLabel":"object"},"description":"Structured warnings emitted when the gateway modifies or ignores\npart of the request (e.g., unsupported parameters, blocked fields).\n","uniqueKey":"data.routing_metadata.warnings","typeLabel":"object[]"}},"uniqueKey":"data.routing_metadata","typeLabel":"object"},"service_tier":{"oneOf":[{"type":"string","description":"The service tier used for processing the request. Present for OpenAI-routed models.","uniqueKey":"data.service_tier.oneOf.0","typeLabel":"string"},{"type":"null","description":"The service tier used for processing the request. Present for OpenAI-routed models.","uniqueKey":"data.service_tier.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.service_tier","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":"data: {\"id\":\"chatcmpl-abc123\",\"object\":\"chat.completion.chunk\",\"created\":1745100000,\"model\":\"gpt-4o-2024-08-06\",\"system_fingerprint\":\"fp_d08c293973\",\"choices\":[{\"index\":0,\"delta\":{\"role\":\"assistant\",\"content\":\"\"},\"logprobs\":null,\"finish_reason\":null}]}\n\ndata: {\"id\":\"chatcmpl-abc123\",\"object\":\"chat.completion.chunk\",\"created\":1745100000,\"model\":\"gpt-4o-2024-08-06\",\"system_fingerprint\":\"fp_d08c293973\",\"choices\":[{\"index\":0,\"delta\":{\"content\":\"The\"},\"logprobs\":null,\"finish_reason\":null}]}\n\n....\n\ndata: {\"id\":\"chatcmpl-abc123\",\"object\":\"chat.completion.chunk\",\"created\":1745100000,\"model\":\"gpt-4o-2024-08-06\",\"system_fingerprint\":\"fp_d08c293973\",\"choices\":[{\"index\":0,\"delta\":{},\"logprobs\":null,\"finish_reason\":\"stop\"}]}\n\ndata: {\"id\":\"chatcmpl-abc123\",\"object\":\"chat.completion.chunk\",\"created\":1745100000,\"model\":\"gpt-4o-2024-08-06\",\"system_fingerprint\":\"fp_d08c293973\",\"choices\":[],\"usage\":{\"prompt_tokens\":14,\"completion_tokens\":7,\"total_tokens\":21}}\n\ndata: {\"id\":\"chatcmpl-abc123\",\"object\":\"chat.completion.chunk\",\"created\":1745100000,\"model\":\"gpt-4o-2024-08-06\",\"choices\":[],\"routing_metadata\":{\"provider\":\"openai\",\"provider_model_id\":\"gpt-4o-2024-08-06\",\"model_canonical\":\"gpt-4o\",\"routing_strategy\":\"cost-focus\",\"ttft_ms\":977,\"throughput_tps\":350,\"cost\":{\"usd\":0.000105}}}\n\ndata: [DONE]\n","examples":{"Example":{"title":"Example","value":"data: {\"id\":\"chatcmpl-abc123\",\"object\":\"chat.completion.chunk\",\"created\":1745100000,\"model\":\"gpt-4o-2024-08-06\",\"system_fingerprint\":\"fp_d08c293973\",\"choices\":[{\"index\":0,\"delta\":{\"role\":\"assistant\",\"content\":\"\"},\"logprobs\":null,\"finish_reason\":null}]}\n\ndata: {\"id\":\"chatcmpl-abc123\",\"object\":\"chat.completion.chunk\",\"created\":1745100000,\"model\":\"gpt-4o-2024-08-06\",\"system_fingerprint\":\"fp_d08c293973\",\"choices\":[{\"index\":0,\"delta\":{\"content\":\"The\"},\"logprobs\":null,\"finish_reason\":null}]}\n\n....\n\ndata: {\"id\":\"chatcmpl-abc123\",\"object\":\"chat.completion.chunk\",\"created\":1745100000,\"model\":\"gpt-4o-2024-08-06\",\"system_fingerprint\":\"fp_d08c293973\",\"choices\":[{\"index\":0,\"delta\":{},\"logprobs\":null,\"finish_reason\":\"stop\"}]}\n\ndata: {\"id\":\"chatcmpl-abc123\",\"object\":\"chat.completion.chunk\",\"created\":1745100000,\"model\":\"gpt-4o-2024-08-06\",\"system_fingerprint\":\"fp_d08c293973\",\"choices\":[],\"usage\":{\"prompt_tokens\":14,\"completion_tokens\":7,\"total_tokens\":21}}\n\ndata: {\"id\":\"chatcmpl-abc123\",\"object\":\"chat.completion.chunk\",\"created\":1745100000,\"model\":\"gpt-4o-2024-08-06\",\"choices\":[],\"routing_metadata\":{\"provider\":\"openai\",\"provider_model_id\":\"gpt-4o-2024-08-06\",\"model_canonical\":\"gpt-4o\",\"routing_strategy\":\"cost-focus\",\"ttft_ms\":977,\"throughput_tps\":350,\"cost\":{\"usd\":0.000105}}}\n\ndata: [DONE]\n"}},"exampleType":"examples"}},"exampleType":"examples"},"3fe70ce2-cf91-4e44-8529-ecf396067b17":{"description":"Bad request - invalid parameters","headers":{"X-Request-ID":{"description":"Unique request identifier for debugging and support.\nInclude this in support requests for fast resolution.\n","schema":{"type":"string"},"example":"req_abc123def456"},"X-Error-Type":{"description":"Same value as the `error.type` field in the response body, exposed as a\nheader for programmatic routing without body parsing.\n","schema":{"type":"string","enum":["invalid_request_error","rate_limit_error","api_error","authentication_error","not_found_error","permission_error"]},"example":"invalid_request_error"},"X-Error-Retryable":{"description":"Whether the client should retry this request.\n'true' for api_error and rate_limit_error types; 'false' for all others.\n","schema":{"type":"string","enum":["true","false"]},"example":"false"}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"OpenAI-compatible error format","required":["message","type","param","code"],"properties":{"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Error category per guide §4.","enum":["invalid_request_error","authentication_error","permission_error","not_found_error","rate_limit_error","api_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"param":{"oneOf":[{"type":"string","description":"Parameter that caused the error (null if not applicable)","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Parameter that caused the error (null if not applicable)","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"type":"string","description":"Canonical code per guide §5 and docs/reference/error_codes.json.","enum":["invalid_api_key","expired_api_key","insufficient_permissions","feature_disabled","mfa_required","invalid_recovery_code","mfa_verification_failed","invalid_request","missing_required_parameter","invalid_parameter_value","payload_too_large","context_length_exceeded","content_filtered","idempotency_conflict","idempotency_replay_unavailable","field_immutable","operation_not_allowed","unknown_field","state_precondition_failed","duplicate_resource","method_not_allowed","payment_declined","payment_method_invalid","tools_not_supported","json_mode_not_supported","structured_output_not_supported","tools_with_structured_output_not_supported","vision_not_supported","reasoning_not_supported","thinking_disable_not_supported","streaming_not_supported","non_streaming_not_supported","batch_only","tier_opt_in_required","tool_choice_required_not_supported","cost_constraint_exceeded","latency_constraint_exceeded","throughput_constraint_not_met","provider_not_in_allowlist","provider_blocked","required_params_not_supported","byok_keys_required","platform_keys_unavailable","unsupported_modalities","no_compatible_endpoint","no_responses_endpoint","input_requires_responses_endpoint","response_api_only","hosted_tool_not_supported","no_tools_on_endpoint","model_not_found","resource_not_found","rate_limit_exceeded","budget_exhausted","insufficient_quota","no_provider_available","upstream_error","upstream_timeout","client_disconnected","stream_duration_exceeded","model_unavailable","internal_error","service_unavailable"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"doc_url":{"type":"string","description":"Link to the canonical documentation page for this error code.","uniqueKey":"error.doc_url","typeLabel":"string"},"provider":{"oneOf":[{"type":"string","description":"Upstream provider that generated the error (e.g., \"google_ai_studio\", \"openai\"). Null for errors not attributable to an upstream provider (local validation, auth, internal config).","uniqueKey":"error.provider.oneOf.0","typeLabel":"string"},{"type":"null","description":"Upstream provider that generated the error (e.g., \"google_ai_studio\", \"openai\"). Null for errors not attributable to an upstream provider (local validation, auth, internal config).","uniqueKey":"error.provider.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.provider","typeLabel":"string | null"},"suggestion":{"type":"string","description":"Actionable fix hint for routing, capability, or model-not-found errors. Absent for other error types.","uniqueKey":"error.suggestion","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"missing_model":{"title":"missing_model","summary":"Missing model parameter","value":{"error":{"message":"Missing required parameter: 'model'.","type":"invalid_request_error","param":"model","code":"missing_required_parameter"}}},"invalid_models":{"title":"invalid_models","summary":"Invalid models array","value":{"error":{"message":"gateway.models array cannot exceed 10 models","type":"invalid_request_error","param":"gateway.models","code":"invalid_request"}}},"vision_not_supported":{"title":"vision_not_supported","summary":"Model doesn't support requested capability","value":{"error":{"message":"Model 'gpt-4.1-mini' does not support vision/image input.","type":"invalid_request_error","param":null,"code":"vision_not_supported"}}},"cost_constraint_exceeded":{"title":"cost_constraint_exceeded","summary":"Routing constraints excluded all providers","value":{"error":{"message":"No provider meets the cost constraint for model 'gpt-4o'.","type":"invalid_request_error","param":"gateway.routing.max_cost_per_1m","code":"cost_constraint_exceeded"}}}},"exampleType":"examples"}},"exampleType":"examples"},"21fdaee6-67bd-4c79-a7cd-da90c0dc5619":{"description":"Authentication failed","headers":{"X-Request-ID":{"description":"Unique request identifier for debugging and support.\nInclude this in support requests for fast resolution.\n","schema":{"type":"string"},"example":"req_abc123def456"},"X-Error-Type":{"description":"Same value as the `error.type` field in the response body, exposed as a\nheader for programmatic routing without body parsing.\n","schema":{"type":"string","enum":["invalid_request_error","rate_limit_error","api_error","authentication_error","not_found_error","permission_error"]},"example":"invalid_request_error"},"X-Error-Retryable":{"description":"Whether the client should retry this request.\n'true' for api_error and rate_limit_error types; 'false' for all others.\n","schema":{"type":"string","enum":["true","false"]},"example":"false"}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"OpenAI-compatible error format","required":["message","type","param","code"],"properties":{"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Error category per guide §4.","enum":["invalid_request_error","authentication_error","permission_error","not_found_error","rate_limit_error","api_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"param":{"oneOf":[{"type":"string","description":"Parameter that caused the error (null if not applicable)","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Parameter that caused the error (null if not applicable)","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"type":"string","description":"Canonical code per guide §5 and docs/reference/error_codes.json.","enum":["invalid_api_key","expired_api_key","insufficient_permissions","feature_disabled","mfa_required","invalid_recovery_code","mfa_verification_failed","invalid_request","missing_required_parameter","invalid_parameter_value","payload_too_large","context_length_exceeded","content_filtered","idempotency_conflict","idempotency_replay_unavailable","field_immutable","operation_not_allowed","unknown_field","state_precondition_failed","duplicate_resource","method_not_allowed","payment_declined","payment_method_invalid","tools_not_supported","json_mode_not_supported","structured_output_not_supported","tools_with_structured_output_not_supported","vision_not_supported","reasoning_not_supported","thinking_disable_not_supported","streaming_not_supported","non_streaming_not_supported","batch_only","tier_opt_in_required","tool_choice_required_not_supported","cost_constraint_exceeded","latency_constraint_exceeded","throughput_constraint_not_met","provider_not_in_allowlist","provider_blocked","required_params_not_supported","byok_keys_required","platform_keys_unavailable","unsupported_modalities","no_compatible_endpoint","no_responses_endpoint","input_requires_responses_endpoint","response_api_only","hosted_tool_not_supported","no_tools_on_endpoint","model_not_found","resource_not_found","rate_limit_exceeded","budget_exhausted","insufficient_quota","no_provider_available","upstream_error","upstream_timeout","client_disconnected","stream_duration_exceeded","model_unavailable","internal_error","service_unavailable"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"doc_url":{"type":"string","description":"Link to the canonical documentation page for this error code.","uniqueKey":"error.doc_url","typeLabel":"string"},"provider":{"oneOf":[{"type":"string","description":"Upstream provider that generated the error (e.g., \"google_ai_studio\", \"openai\"). Null for errors not attributable to an upstream provider (local validation, auth, internal config).","uniqueKey":"error.provider.oneOf.0","typeLabel":"string"},{"type":"null","description":"Upstream provider that generated the error (e.g., \"google_ai_studio\", \"openai\"). Null for errors not attributable to an upstream provider (local validation, auth, internal config).","uniqueKey":"error.provider.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.provider","typeLabel":"string | null"},"suggestion":{"type":"string","description":"Actionable fix hint for routing, capability, or model-not-found errors. Absent for other error types.","uniqueKey":"error.suggestion","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"message":"API key is invalid.","type":"authentication_error","param":null,"code":"invalid_api_key"}},"examples":{"Example":{"title":"Example","value":{"error":{"message":"API key is invalid.","type":"authentication_error","param":null,"code":"invalid_api_key"}}}},"exampleType":"examples"}},"exampleType":"examples"},"dd345fa2-56ef-4e3c-a68e-5d9bc6a7b548":{"description":"Model not found","headers":{"X-Request-ID":{"description":"Unique request identifier for debugging and support.\nInclude this in support requests for fast resolution.\n","schema":{"type":"string"},"example":"req_abc123def456"},"X-Error-Type":{"description":"Same value as the `error.type` field in the response body, exposed as a\nheader for programmatic routing without body parsing.\n","schema":{"type":"string","enum":["invalid_request_error","rate_limit_error","api_error","authentication_error","not_found_error","permission_error"]},"example":"invalid_request_error"},"X-Error-Retryable":{"description":"Whether the client should retry this request.\n'true' for api_error and rate_limit_error types; 'false' for all others.\n","schema":{"type":"string","enum":["true","false"]},"example":"false"}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"OpenAI-compatible error format","required":["message","type","param","code"],"properties":{"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Error category per guide §4.","enum":["invalid_request_error","authentication_error","permission_error","not_found_error","rate_limit_error","api_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"param":{"oneOf":[{"type":"string","description":"Parameter that caused the error (null if not applicable)","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Parameter that caused the error (null if not applicable)","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"type":"string","description":"Canonical code per guide §5 and docs/reference/error_codes.json.","enum":["invalid_api_key","expired_api_key","insufficient_permissions","feature_disabled","mfa_required","invalid_recovery_code","mfa_verification_failed","invalid_request","missing_required_parameter","invalid_parameter_value","payload_too_large","context_length_exceeded","content_filtered","idempotency_conflict","idempotency_replay_unavailable","field_immutable","operation_not_allowed","unknown_field","state_precondition_failed","duplicate_resource","method_not_allowed","payment_declined","payment_method_invalid","tools_not_supported","json_mode_not_supported","structured_output_not_supported","tools_with_structured_output_not_supported","vision_not_supported","reasoning_not_supported","thinking_disable_not_supported","streaming_not_supported","non_streaming_not_supported","batch_only","tier_opt_in_required","tool_choice_required_not_supported","cost_constraint_exceeded","latency_constraint_exceeded","throughput_constraint_not_met","provider_not_in_allowlist","provider_blocked","required_params_not_supported","byok_keys_required","platform_keys_unavailable","unsupported_modalities","no_compatible_endpoint","no_responses_endpoint","input_requires_responses_endpoint","response_api_only","hosted_tool_not_supported","no_tools_on_endpoint","model_not_found","resource_not_found","rate_limit_exceeded","budget_exhausted","insufficient_quota","no_provider_available","upstream_error","upstream_timeout","client_disconnected","stream_duration_exceeded","model_unavailable","internal_error","service_unavailable"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"doc_url":{"type":"string","description":"Link to the canonical documentation page for this error code.","uniqueKey":"error.doc_url","typeLabel":"string"},"provider":{"oneOf":[{"type":"string","description":"Upstream provider that generated the error (e.g., \"google_ai_studio\", \"openai\"). Null for errors not attributable to an upstream provider (local validation, auth, internal config).","uniqueKey":"error.provider.oneOf.0","typeLabel":"string"},{"type":"null","description":"Upstream provider that generated the error (e.g., \"google_ai_studio\", \"openai\"). Null for errors not attributable to an upstream provider (local validation, auth, internal config).","uniqueKey":"error.provider.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.provider","typeLabel":"string | null"},"suggestion":{"type":"string","description":"Actionable fix hint for routing, capability, or model-not-found errors. Absent for other error types.","uniqueKey":"error.suggestion","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"message":"Model 'unknown-model' is not in the catalog. See https://api.auriko.ai/v1/directory/models for available models.","type":"not_found_error","param":"model","code":"model_not_found"}},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Model 'unknown-model' is not in the catalog. See https://api.auriko.ai/v1/directory/models for available models.","type":"not_found_error","param":"model","code":"model_not_found"}}}},"exampleType":"examples"}},"exampleType":"examples"},"42f56ad1-816a-4f2c-8430-296d0b699a91":{"description":"Rate limit exceeded. Two sub-causes share this status:\n- `rate_limit_exceeded`: throughput-based rate limit.\n- `budget_exhausted`: account or project budget reached (self-service;\n not auto-retried by SDKs — requires adding credits or raising the limit).\n","headers":{"X-Request-ID":{"description":"Unique request identifier for debugging and support.\nInclude this in support requests for fast resolution.\n","schema":{"type":"string"},"example":"req_abc123def456"},"X-Error-Type":{"description":"Same value as the `error.type` field in the response body, exposed as a\nheader for programmatic routing without body parsing.\n","schema":{"type":"string","enum":["invalid_request_error","rate_limit_error","api_error","authentication_error","not_found_error","permission_error"]},"example":"invalid_request_error"},"X-Error-Retryable":{"description":"Whether the client should retry this request.\n'true' for api_error and rate_limit_error types; 'false' for all others.\n","schema":{"type":"string","enum":["true","false"]},"example":"false"},"Retry-After":{"description":"Seconds until rate limit resets. Standard HTTP header for retry backoff.","schema":{"type":"integer"},"example":60},"X-Rate-Limit-Source":{"description":"Identifies the origin of the rate limit: upstream provider, Auriko's routing layer, an API key's configured limit (key), or the account tier default (tier).\n","schema":{"type":"string","enum":["provider","routing","key","tier"]},"required":false,"example":"provider"},"X-RateLimit-Limit-Requests":{"description":"Request limit per window (present on throughput-based rate limits)","schema":{"type":"integer"},"required":false,"example":60},"X-RateLimit-Remaining-Requests":{"description":"Remaining requests in window (present on throughput-based rate limits)","schema":{"type":"integer"},"required":false,"example":0},"X-RateLimit-Reset-Requests":{"description":"When limit resets (ISO 8601 format; present on throughput-based rate limits)","schema":{"type":"string","format":"date-time"},"required":false,"example":"2026-06-15T12:01:00.000Z"},"X-Budget-Exceeded":{"description":"Present on budget-exhaustion 429s.","schema":{"type":"string","enum":["true","false"]},"required":false,"example":"true"},"X-Budget-Exceeded-Period":{"description":"Period of the exceeded budget (present on budget-exhaustion 429s).","schema":{"type":"string","enum":["daily","weekly","monthly"]},"required":false,"example":"monthly"},"X-Budget-Exceeded-Scope":{"description":"Scope of the exceeded budget (present on budget-exhaustion 429s).","schema":{"type":"string","enum":["workspace","api_key","byok_provider"]},"required":false,"example":"workspace"}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"OpenAI-compatible error format","required":["message","type","param","code"],"properties":{"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Error category per guide §4.","enum":["invalid_request_error","authentication_error","permission_error","not_found_error","rate_limit_error","api_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"param":{"oneOf":[{"type":"string","description":"Parameter that caused the error (null if not applicable)","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Parameter that caused the error (null if not applicable)","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"type":"string","description":"Canonical code per guide §5 and docs/reference/error_codes.json.","enum":["invalid_api_key","expired_api_key","insufficient_permissions","feature_disabled","mfa_required","invalid_recovery_code","mfa_verification_failed","invalid_request","missing_required_parameter","invalid_parameter_value","payload_too_large","context_length_exceeded","content_filtered","idempotency_conflict","idempotency_replay_unavailable","field_immutable","operation_not_allowed","unknown_field","state_precondition_failed","duplicate_resource","method_not_allowed","payment_declined","payment_method_invalid","tools_not_supported","json_mode_not_supported","structured_output_not_supported","tools_with_structured_output_not_supported","vision_not_supported","reasoning_not_supported","thinking_disable_not_supported","streaming_not_supported","non_streaming_not_supported","batch_only","tier_opt_in_required","tool_choice_required_not_supported","cost_constraint_exceeded","latency_constraint_exceeded","throughput_constraint_not_met","provider_not_in_allowlist","provider_blocked","required_params_not_supported","byok_keys_required","platform_keys_unavailable","unsupported_modalities","no_compatible_endpoint","no_responses_endpoint","input_requires_responses_endpoint","response_api_only","hosted_tool_not_supported","no_tools_on_endpoint","model_not_found","resource_not_found","rate_limit_exceeded","budget_exhausted","insufficient_quota","no_provider_available","upstream_error","upstream_timeout","client_disconnected","stream_duration_exceeded","model_unavailable","internal_error","service_unavailable"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"doc_url":{"type":"string","description":"Link to the canonical documentation page for this error code.","uniqueKey":"error.doc_url","typeLabel":"string"},"provider":{"oneOf":[{"type":"string","description":"Upstream provider that generated the error (e.g., \"google_ai_studio\", \"openai\"). Null for errors not attributable to an upstream provider (local validation, auth, internal config).","uniqueKey":"error.provider.oneOf.0","typeLabel":"string"},{"type":"null","description":"Upstream provider that generated the error (e.g., \"google_ai_studio\", \"openai\"). Null for errors not attributable to an upstream provider (local validation, auth, internal config).","uniqueKey":"error.provider.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.provider","typeLabel":"string | null"},"suggestion":{"type":"string","description":"Actionable fix hint for routing, capability, or model-not-found errors. Absent for other error types.","uniqueKey":"error.suggestion","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"rate_limit_exceeded":{"title":"rate_limit_exceeded","summary":"Throughput-based rate limit","value":{"error":{"message":"Rate limit exceeded. Retry after 60 seconds.","type":"rate_limit_error","param":null,"code":"rate_limit_exceeded"}}},"budget_exhausted":{"title":"budget_exhausted","summary":"Account budget exhausted","value":{"error":{"message":"Account budget exhausted. Add credits to continue.","type":"rate_limit_error","param":null,"code":"budget_exhausted"}}}},"exampleType":"examples"}},"exampleType":"examples"},"cc1c36b8-777c-4fc5-a46c-fde92feaa79f":{"description":"Internal server error","headers":{"X-Request-ID":{"description":"Unique request identifier for debugging and support.\nInclude this in support requests for fast resolution.\n","schema":{"type":"string"},"example":"req_abc123def456"},"X-Error-Type":{"description":"Same value as the `error.type` field in the response body, exposed as a\nheader for programmatic routing without body parsing.\n","schema":{"type":"string","enum":["invalid_request_error","rate_limit_error","api_error","authentication_error","not_found_error","permission_error"]},"example":"invalid_request_error"},"X-Error-Retryable":{"description":"Whether the client should retry this request.\n'true' for api_error and rate_limit_error types; 'false' for all others.\n","schema":{"type":"string","enum":["true","false"]},"example":"false"}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"OpenAI-compatible error format","required":["message","type","param","code"],"properties":{"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Error category per guide §4.","enum":["invalid_request_error","authentication_error","permission_error","not_found_error","rate_limit_error","api_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"param":{"oneOf":[{"type":"string","description":"Parameter that caused the error (null if not applicable)","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Parameter that caused the error (null if not applicable)","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"type":"string","description":"Canonical code per guide §5 and docs/reference/error_codes.json.","enum":["invalid_api_key","expired_api_key","insufficient_permissions","feature_disabled","mfa_required","invalid_recovery_code","mfa_verification_failed","invalid_request","missing_required_parameter","invalid_parameter_value","payload_too_large","context_length_exceeded","content_filtered","idempotency_conflict","idempotency_replay_unavailable","field_immutable","operation_not_allowed","unknown_field","state_precondition_failed","duplicate_resource","method_not_allowed","payment_declined","payment_method_invalid","tools_not_supported","json_mode_not_supported","structured_output_not_supported","tools_with_structured_output_not_supported","vision_not_supported","reasoning_not_supported","thinking_disable_not_supported","streaming_not_supported","non_streaming_not_supported","batch_only","tier_opt_in_required","tool_choice_required_not_supported","cost_constraint_exceeded","latency_constraint_exceeded","throughput_constraint_not_met","provider_not_in_allowlist","provider_blocked","required_params_not_supported","byok_keys_required","platform_keys_unavailable","unsupported_modalities","no_compatible_endpoint","no_responses_endpoint","input_requires_responses_endpoint","response_api_only","hosted_tool_not_supported","no_tools_on_endpoint","model_not_found","resource_not_found","rate_limit_exceeded","budget_exhausted","insufficient_quota","no_provider_available","upstream_error","upstream_timeout","client_disconnected","stream_duration_exceeded","model_unavailable","internal_error","service_unavailable"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"doc_url":{"type":"string","description":"Link to the canonical documentation page for this error code.","uniqueKey":"error.doc_url","typeLabel":"string"},"provider":{"oneOf":[{"type":"string","description":"Upstream provider that generated the error (e.g., \"google_ai_studio\", \"openai\"). Null for errors not attributable to an upstream provider (local validation, auth, internal config).","uniqueKey":"error.provider.oneOf.0","typeLabel":"string"},{"type":"null","description":"Upstream provider that generated the error (e.g., \"google_ai_studio\", \"openai\"). Null for errors not attributable to an upstream provider (local validation, auth, internal config).","uniqueKey":"error.provider.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.provider","typeLabel":"string | null"},"suggestion":{"type":"string","description":"Actionable fix hint for routing, capability, or model-not-found errors. Absent for other error types.","uniqueKey":"error.suggestion","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"message":"An unexpected error occurred. Contact support with the request ID.","type":"api_error","param":null,"code":"internal_error"}},"examples":{"Example":{"title":"Example","value":{"error":{"message":"An unexpected error occurred. Contact support with the request ID.","type":"api_error","param":null,"code":"internal_error"}}}},"exampleType":"examples"}},"exampleType":"examples"},"963156ab-b611-4814-a2dd-fdf8ed084621":{"description":"Upstream provider failure (Bad Gateway).\n\nAll non-timeout 5xx errors from upstream providers are normalized to 502 (code: `upstream_error`).\nUpstream failures may also surface as:\n- 429: Provider rate limit (code: `rate_limit_exceeded`)\n- 504: Provider timed out (code: `upstream_timeout`)\n\nThese use their respective status codes with the same `ErrorResponse` body format.\n","headers":{"X-Request-ID":{"description":"Unique request identifier for debugging and support.\nInclude this in support requests for fast resolution.\n","schema":{"type":"string"},"example":"req_abc123def456"},"X-Error-Type":{"description":"Canonical error type (one of the X-Error-Type enum values)","schema":{"type":"string"},"required":false},"X-Error-Retryable":{"description":"Whether the error is retryable ('true' or 'false')","schema":{"type":"string","enum":["true","false"]},"required":false},"Retry-After":{"description":"Seconds to wait before retrying (present on rate limit errors)","schema":{"type":"integer"},"required":false}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"OpenAI-compatible error format","required":["message","type","param","code"],"properties":{"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Error category per guide §4.","enum":["invalid_request_error","authentication_error","permission_error","not_found_error","rate_limit_error","api_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"param":{"oneOf":[{"type":"string","description":"Parameter that caused the error (null if not applicable)","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Parameter that caused the error (null if not applicable)","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"type":"string","description":"Canonical code per guide §5 and docs/reference/error_codes.json.","enum":["invalid_api_key","expired_api_key","insufficient_permissions","feature_disabled","mfa_required","invalid_recovery_code","mfa_verification_failed","invalid_request","missing_required_parameter","invalid_parameter_value","payload_too_large","context_length_exceeded","content_filtered","idempotency_conflict","idempotency_replay_unavailable","field_immutable","operation_not_allowed","unknown_field","state_precondition_failed","duplicate_resource","method_not_allowed","payment_declined","payment_method_invalid","tools_not_supported","json_mode_not_supported","structured_output_not_supported","tools_with_structured_output_not_supported","vision_not_supported","reasoning_not_supported","thinking_disable_not_supported","streaming_not_supported","non_streaming_not_supported","batch_only","tier_opt_in_required","tool_choice_required_not_supported","cost_constraint_exceeded","latency_constraint_exceeded","throughput_constraint_not_met","provider_not_in_allowlist","provider_blocked","required_params_not_supported","byok_keys_required","platform_keys_unavailable","unsupported_modalities","no_compatible_endpoint","no_responses_endpoint","input_requires_responses_endpoint","response_api_only","hosted_tool_not_supported","no_tools_on_endpoint","model_not_found","resource_not_found","rate_limit_exceeded","budget_exhausted","insufficient_quota","no_provider_available","upstream_error","upstream_timeout","client_disconnected","stream_duration_exceeded","model_unavailable","internal_error","service_unavailable"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"doc_url":{"type":"string","description":"Link to the canonical documentation page for this error code.","uniqueKey":"error.doc_url","typeLabel":"string"},"provider":{"oneOf":[{"type":"string","description":"Upstream provider that generated the error (e.g., \"google_ai_studio\", \"openai\"). Null for errors not attributable to an upstream provider (local validation, auth, internal config).","uniqueKey":"error.provider.oneOf.0","typeLabel":"string"},{"type":"null","description":"Upstream provider that generated the error (e.g., \"google_ai_studio\", \"openai\"). Null for errors not attributable to an upstream provider (local validation, auth, internal config).","uniqueKey":"error.provider.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.provider","typeLabel":"string | null"},"suggestion":{"type":"string","description":"Actionable fix hint for routing, capability, or model-not-found errors. Absent for other error types.","uniqueKey":"error.suggestion","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"message":"Model 'gpt-4o' is temporarily unavailable. Retry in a few seconds.","type":"api_error","param":null,"code":"upstream_error"}},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Model 'gpt-4o' is temporarily unavailable. Retry in a few seconds.","type":"api_error","param":null,"code":"upstream_error"}}}},"exampleType":"examples"}},"exampleType":"examples"},"86105ee1-d45e-4658-8308-d6fafbf8dc9a":{"description":"Service unavailable — transient issue. Possible causes:\n- All providers for the model are rate-limited or temporarily unavailable (`no_provider_available`)\n- Transient infrastructure issue (`service_unavailable`)\n\nNote: If the model doesn't support a requested capability (e.g., reasoning),\nthe response is 400 with a specific code (e.g., `reasoning_not_supported`), not 503.\nIf routing constraints excluded all providers, the response is 400 with a\nspecific constraint code (e.g., `cost_constraint_exceeded`).\n","headers":{"X-Request-ID":{"description":"Unique request identifier for debugging and support.\nInclude this in support requests for fast resolution.\n","schema":{"type":"string"},"example":"req_abc123def456"},"X-Error-Type":{"description":"Same value as the `error.type` field in the response body, exposed as a\nheader for programmatic routing without body parsing.\n","schema":{"type":"string","enum":["invalid_request_error","rate_limit_error","api_error","authentication_error","not_found_error","permission_error"]},"example":"invalid_request_error"},"X-Error-Retryable":{"description":"Whether the client should retry this request.\n'true' for api_error and rate_limit_error types; 'false' for all others.\n","schema":{"type":"string","enum":["true","false"]},"example":"false"},"Retry-After":{"description":"Seconds to wait before retrying (present on transient failures)","schema":{"type":"integer"},"required":false}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"OpenAI-compatible error format","required":["message","type","param","code"],"properties":{"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Error category per guide §4.","enum":["invalid_request_error","authentication_error","permission_error","not_found_error","rate_limit_error","api_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"param":{"oneOf":[{"type":"string","description":"Parameter that caused the error (null if not applicable)","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Parameter that caused the error (null if not applicable)","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"type":"string","description":"Canonical code per guide §5 and docs/reference/error_codes.json.","enum":["invalid_api_key","expired_api_key","insufficient_permissions","feature_disabled","mfa_required","invalid_recovery_code","mfa_verification_failed","invalid_request","missing_required_parameter","invalid_parameter_value","payload_too_large","context_length_exceeded","content_filtered","idempotency_conflict","idempotency_replay_unavailable","field_immutable","operation_not_allowed","unknown_field","state_precondition_failed","duplicate_resource","method_not_allowed","payment_declined","payment_method_invalid","tools_not_supported","json_mode_not_supported","structured_output_not_supported","tools_with_structured_output_not_supported","vision_not_supported","reasoning_not_supported","thinking_disable_not_supported","streaming_not_supported","non_streaming_not_supported","batch_only","tier_opt_in_required","tool_choice_required_not_supported","cost_constraint_exceeded","latency_constraint_exceeded","throughput_constraint_not_met","provider_not_in_allowlist","provider_blocked","required_params_not_supported","byok_keys_required","platform_keys_unavailable","unsupported_modalities","no_compatible_endpoint","no_responses_endpoint","input_requires_responses_endpoint","response_api_only","hosted_tool_not_supported","no_tools_on_endpoint","model_not_found","resource_not_found","rate_limit_exceeded","budget_exhausted","insufficient_quota","no_provider_available","upstream_error","upstream_timeout","client_disconnected","stream_duration_exceeded","model_unavailable","internal_error","service_unavailable"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"doc_url":{"type":"string","description":"Link to the canonical documentation page for this error code.","uniqueKey":"error.doc_url","typeLabel":"string"},"provider":{"oneOf":[{"type":"string","description":"Upstream provider that generated the error (e.g., \"google_ai_studio\", \"openai\"). Null for errors not attributable to an upstream provider (local validation, auth, internal config).","uniqueKey":"error.provider.oneOf.0","typeLabel":"string"},{"type":"null","description":"Upstream provider that generated the error (e.g., \"google_ai_studio\", \"openai\"). Null for errors not attributable to an upstream provider (local validation, auth, internal config).","uniqueKey":"error.provider.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.provider","typeLabel":"string | null"},"suggestion":{"type":"string","description":"Actionable fix hint for routing, capability, or model-not-found errors. Absent for other error types.","uniqueKey":"error.suggestion","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"no_providers":{"title":"no_providers","summary":"No providers available for the model","value":{"error":{"message":"No provider available for model 'gpt-4o'. Try a different model.","type":"api_error","param":null,"code":"no_provider_available"}}},"service_unavailable":{"title":"service_unavailable","summary":"Transient infrastructure issue","value":{"error":{"message":"Service is temporarily unavailable. Retry in a few seconds.","type":"api_error","param":null,"code":"service_unavailable"}}}},"exampleType":"examples"}},"exampleType":"examples"},"674919ce-706b-48d3-8eda-163a92885623":{"description":"Upstream provider timed out. The client may retry with a longer timeout.\n","headers":{"X-Request-ID":{"description":"Unique request identifier for debugging and support.\nInclude this in support requests for fast resolution.\n","schema":{"type":"string"},"example":"req_abc123def456"},"X-Error-Type":{"description":"Error type (always 'api_error' for timeout responses)","schema":{"type":"string"},"required":false},"X-Error-Retryable":{"description":"Whether the error is retryable ('true' or 'false')","schema":{"type":"string","enum":["true","false"]},"required":false}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"OpenAI-compatible error format","required":["message","type","param","code"],"properties":{"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Error category per guide §4.","enum":["invalid_request_error","authentication_error","permission_error","not_found_error","rate_limit_error","api_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"param":{"oneOf":[{"type":"string","description":"Parameter that caused the error (null if not applicable)","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Parameter that caused the error (null if not applicable)","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"type":"string","description":"Canonical code per guide §5 and docs/reference/error_codes.json.","enum":["invalid_api_key","expired_api_key","insufficient_permissions","feature_disabled","mfa_required","invalid_recovery_code","mfa_verification_failed","invalid_request","missing_required_parameter","invalid_parameter_value","payload_too_large","context_length_exceeded","content_filtered","idempotency_conflict","idempotency_replay_unavailable","field_immutable","operation_not_allowed","unknown_field","state_precondition_failed","duplicate_resource","method_not_allowed","payment_declined","payment_method_invalid","tools_not_supported","json_mode_not_supported","structured_output_not_supported","tools_with_structured_output_not_supported","vision_not_supported","reasoning_not_supported","thinking_disable_not_supported","streaming_not_supported","non_streaming_not_supported","batch_only","tier_opt_in_required","tool_choice_required_not_supported","cost_constraint_exceeded","latency_constraint_exceeded","throughput_constraint_not_met","provider_not_in_allowlist","provider_blocked","required_params_not_supported","byok_keys_required","platform_keys_unavailable","unsupported_modalities","no_compatible_endpoint","no_responses_endpoint","input_requires_responses_endpoint","response_api_only","hosted_tool_not_supported","no_tools_on_endpoint","model_not_found","resource_not_found","rate_limit_exceeded","budget_exhausted","insufficient_quota","no_provider_available","upstream_error","upstream_timeout","client_disconnected","stream_duration_exceeded","model_unavailable","internal_error","service_unavailable"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"doc_url":{"type":"string","description":"Link to the canonical documentation page for this error code.","uniqueKey":"error.doc_url","typeLabel":"string"},"provider":{"oneOf":[{"type":"string","description":"Upstream provider that generated the error (e.g., \"google_ai_studio\", \"openai\"). Null for errors not attributable to an upstream provider (local validation, auth, internal config).","uniqueKey":"error.provider.oneOf.0","typeLabel":"string"},{"type":"null","description":"Upstream provider that generated the error (e.g., \"google_ai_studio\", \"openai\"). Null for errors not attributable to an upstream provider (local validation, auth, internal config).","uniqueKey":"error.provider.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.provider","typeLabel":"string | null"},"suggestion":{"type":"string","description":"Actionable fix hint for routing, capability, or model-not-found errors. Absent for other error types.","uniqueKey":"error.suggestion","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"message":"Model 'gpt-4o' timed out. Retry or use a smaller input.","type":"api_error","param":null,"code":"upstream_timeout"}},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Model 'gpt-4o' timed out. Retry or use a smaller input.","type":"api_error","param":null,"code":"upstream_timeout"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"5dad3c74-38ba-4750-ae5a-89f23079cb7a":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"API key authentication.\nKeys start with `ak_` prefix.\nExample: `Authorization: Bearer ak_live_xxxxxxxxxxxx`\n","scopes":[]}}},"servers":{"7a684522-107c-44d9-947d-4e0fc7defa27":{"url":"https://api.auriko.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key authentication.\nKeys start with `ak_` prefix.\nExample: `Authorization: Bearer ak_live_xxxxxxxxxxxx`\n","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key authentication.\nKeys start with `ak_` prefix.\nExample: `Authorization: Bearer ak_live_xxxxxxxxxxxx`\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"auriko","siteName":"Auriko","title":"Create Chat Completion - Auriko","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-14T03:02:35.297Z","originalFileLocation":"api-reference/chat-completions.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a model response for a chat conversation with intelligent routing\">\u003cmeta data-mint-head name=\"application-name\" content=\"Auriko\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/auriko/7DJ_JVLmhIccRobw/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/auriko/7DJ_JVLmhIccRobw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/auriko/7DJ_JVLmhIccRobw/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/auriko/7DJ_JVLmhIccRobw/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/auriko/7DJ_JVLmhIccRobw/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/auriko/7DJ_JVLmhIccRobw/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/auriko/7DJ_JVLmhIccRobw/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/auriko/7DJ_JVLmhIccRobw/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/auriko/7DJ_JVLmhIccRobw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Chat Completion - Auriko\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a model response for a chat conversation with intelligent routing\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Auriko\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.auriko.ai/api-reference/chat-completions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://auriko.mintlify.site/_mintlify/api/og/v2?division=Inference\u0026amp;title=Create+Chat+Completion\u0026amp;description=Create+a+model+response+for+a+chat+conversation+with+intelligent+routing\u0026amp;theme=6c346e3dbc150029ebd144bc\u0026amp;signature=a6be7d6b97387eb5cd2b56b580c8f6caa4c56af15a411dd9b12a1200299e73bf\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create Chat Completion - Auriko\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a model response for a chat conversation with intelligent routing\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://auriko.mintlify.site/_mintlify/api/og/v2?division=Inference\u0026amp;title=Create+Chat+Completion\u0026amp;description=Create+a+model+response+for+a+chat+conversation+with+intelligent+routing\u0026amp;theme=6c346e3dbc150029ebd144bc\u0026amp;signature=a6be7d6b97387eb5cd2b56b580c8f6caa4c56af15a411dd9b12a1200299e73bf\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/auriko/7DJ_JVLmhIccRobw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Auriko\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4779EA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.auriko.ai/api-reference/chat-completions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/chat-completions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.auriko.ai/#organization\",\"name\":\"Auriko\",\"url\":\"https://docs.auriko.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/auriko/ZctT69z8zlG3FLhm/logo/light.svg?fit=max\u0026auto=format\u0026n=ZctT69z8zlG3FLhm\u0026q=85\u0026s=9160396833137f89a62e6297d0da13e3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.auriko.ai#website\",\"name\":\"Auriko\",\"url\":\"https://docs.auriko.ai\",\"publisher\":{\"@id\":\"https://docs.auriko.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.auriko.ai/api-reference/chat-completions#webpage\",\"url\":\"https://docs.auriko.ai/api-reference/chat-completions\",\"name\":\"Create Chat Completion\",\"description\":\"Create a model response for a chat conversation with intelligent routing\",\"dateModified\":\"2026-05-14T03:02:35.297Z\",\"isPartOf\":{\"@id\":\"https://docs.auriko.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.auriko.ai/api-reference/chat-completions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.auriko.ai/api-reference/chat-completions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.auriko.ai/api-reference/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Chat Completion\",\"item\":\"https://docs.auriko.ai/api-reference/chat-completions\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.auriko.ai/api-reference/chat-completions#apireference\",\"headline\":\"Create Chat Completion\",\"name\":\"Create Chat Completion\",\"description\":\"Create a model response for a chat conversation with intelligent routing\",\"url\":\"https://docs.auriko.ai/api-reference/chat-completions\",\"mainEntityOfPage\":{\"@id\":\"https://docs.auriko.ai/api-reference/chat-completions#webpage\"},\"dateModified\":\"2026-05-14T03:02:35.297Z\",\"publisher\":{\"@id\":\"https://docs.auriko.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.auriko.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Auriko\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Auriko\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/chat-completions.md","siteName":"Auriko","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"API Overview","href":"/api-reference/overview"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Errors","description":"Error envelope, codes, and retry behavior","href":"/api-reference/errors"},{"group":"Inference","pages":[{"title":"Create Chat Completion","openapi":"POST /v1/chat/completions","href":"/api-reference/chat-completions"},{"title":"Create response","description":"Create a model response using the OpenAI Response API format","openapi":"POST /v1/responses","href":"/api-reference/create-response"}]},{"group":"Models","pages":[{"title":"List callable models","openapi":"GET /v1/models","href":"/api-reference/list-callable-models"},{"title":"Retrieve callable model","openapi":"GET /v1/models/{model_id}","href":"/api-reference/retrieve-callable-model"}]},{"group":"Model Catalog","pages":[{"title":"Model directory","openapi":"GET /v1/directory/models","href":"/api-reference/model-directory"},{"title":"Canonical model records","openapi":"GET /v1/registry/models","href":"/api-reference/canonical-model-records"},{"title":"Provider catalog","openapi":"GET /v1/registry/providers","href":"/api-reference/provider-catalog"}]},{"group":"Account","pages":[{"title":"Get API key identity","openapi":"GET /v1/me","href":"/api-reference/get-api-key-identity"}]},{"group":"API Keys","pages":[{"title":"List API keys","openapi":"GET /v1/workspaces/{workspace_id}/api-keys","href":"/api-reference/list-api-keys"},{"title":"Get API key","openapi":"GET /v1/workspaces/{workspace_id}/api-keys/{api_key_id}","href":"/api-reference/get-api-key"},{"title":"Get API key usage","openapi":"GET /v1/workspaces/{workspace_id}/api-keys/{api_key_id}/usage","href":"/api-reference/get-api-key-usage"},{"title":"Create API key","openapi":"POST /v1/workspaces/{workspace_id}/api-keys","href":"/api-reference/create-api-key"},{"title":"Update API key","openapi":"PATCH /v1/workspaces/{workspace_id}/api-keys/{api_key_id}","href":"/api-reference/update-api-key"},{"title":"Revoke API key","openapi":"DELETE /v1/workspaces/{workspace_id}/api-keys/{api_key_id}","href":"/api-reference/delete-api-key"}]},{"group":"BYOK","pages":[{"title":"List BYOK providers","openapi":"GET /v1/byok/providers","href":"/api-reference/list-byok-providers"},{"title":"List provider account tiers","openapi":"GET /v1/byok/providers/{provider}/tiers","href":"/api-reference/get-byok-provider-tiers"},{"title":"List BYOK keys","openapi":"GET /v1/workspaces/{workspace_id}/byok-keys","href":"/api-reference/list-byok-keys"},{"title":"Create BYOK key","openapi":"POST /v1/workspaces/{workspace_id}/byok-keys","href":"/api-reference/create-byok-key"},{"title":"Get BYOK key","openapi":"GET /v1/workspaces/{workspace_id}/byok-keys/{byok_key_id}","href":"/api-reference/get-byok-key"},{"title":"Update BYOK key","openapi":"PATCH /v1/workspaces/{workspace_id}/byok-keys/{byok_key_id}","href":"/api-reference/update-byok-key"},{"title":"Delete BYOK key","openapi":"DELETE /v1/workspaces/{workspace_id}/byok-keys/{byok_key_id}","href":"/api-reference/delete-byok-key"}]},{"group":"Billing","pages":[{"title":"Get credit balance","openapi":"GET /v1/workspaces/{workspace_id}/billing/balance","href":"/api-reference/get-credit-balance"}]}]}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/sdk/integration-guide"}]}]},"basePath":"","title":"Create Chat Completion - Auriko","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}