{
"error": {
"message": "Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.",
"type": "rate_limit_error",
"param": null,
"code": null
}
}
{
"error": {
"message": "Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.",
"type": "rate_limit_error",
"param": null,
"code": null
}
}
{
"error": {
"message": "Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.",
"type": "rate_limit_error",
"param": null,
"code": null
}
}
{
"error": {
"message": "Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.",
"type": "rate_limit_error",
"param": null,
"code": null
}
}
{
"error": {
"message": "Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.",
"type": "rate_limit_error",
"param": null,
"code": null
}
}
{
"error": {
"message": "Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.",
"type": "rate_limit_error",
"param": null,
"code": null
}
}
{
"error": {
"message": "Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.",
"type": "rate_limit_error",
"param": null,
"code": null
}
}
{
"error": {
"message": "Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.",
"type": "rate_limit_error",
"param": null,
"code": null
}
}
{
"error": {
"message": "Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.",
"type": "rate_limit_error",
"param": null,
"code": null
}
}
Open Models
Chat Completions
Send an OpenAI-compatible chat completions request to a Relace-hosted model.
{
"error": {
"message": "Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.",
"type": "rate_limit_error",
"param": null,
"code": null
}
}
{
"error": {
"message": "Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.",
"type": "rate_limit_error",
"param": null,
"code": null
}
}
{
"error": {
"message": "Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.",
"type": "rate_limit_error",
"param": null,
"code": null
}
}
{
"error": {
"message": "Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.",
"type": "rate_limit_error",
"param": null,
"code": null
}
}
{
"error": {
"message": "Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.",
"type": "rate_limit_error",
"param": null,
"code": null
}
}
{
"error": {
"message": "Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.",
"type": "rate_limit_error",
"param": null,
"code": null
}
}
{
"error": {
"message": "Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.",
"type": "rate_limit_error",
"param": null,
"code": null
}
}
{
"error": {
"message": "Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.",
"type": "rate_limit_error",
"param": null,
"code": null
}
}
{
"error": {
"message": "Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.",
"type": "rate_limit_error",
"param": null,
"code": null
}
}
OpenAI-compatible endpoint for open-weights models hosted on Relace infrastructure. You can also use this by pointing any OpenAI SDK at https://models.relace.ai/v1 with your Relace API key.
Models
Model
model ID
Context
Input
Output
Cached Input
DeepSeek V4 Flash 0423
deepseek-ai/DeepSeek-V4-Flash-0423
1M
$0.0277 / M
$1.28 / M
$0.0277 / M
DeepSeek V4 Flash 0731
deepseek-ai/DeepSeek-V4-Flash-0731
1M
$0.07 / M
$0.14 / M
$0.014 / M
DeepSeek V4 Pro 0423 (Preview)
deepseek-ai/DeepSeek-V4-Pro
1M
$0.45 / M
$3.00 / M
$0.09 / M
DeepSeek V4 Pro 0813
deepseek-ai/DeepSeek-V4-Pro-0813
1M
$0.50 / M
$2.00 / M
$0.05 / M
DeepSeek V4.1 Flash
deepseek-ai/DeepSeek-V4.1-Flash
1M
$0.20 / M
$0.60 / M
$0.008 / M
DeepSeek V4.1 Flash 1017
deepseek-ai/DeepSeek-V4.1-Flash-1017
1M
$0.20 / M
$0.60 / M
$0.008 / M
GLM 5.2
z-ai/glm-5.2
1M
$0.40 / M
$4.00 / M
$0.08 / M
GLM 5.3
z-ai/glm-5.3
1M
$0.75 / M
$2.40 / M
$0.075 / M
GLM 5.3 Flash
z-ai/glm-5.3-flash
1M
$0.075 / M
$0.50 / M
$0.0075 / M
Kimi K3
moonshotai/kimi-k3
1M
$2.00 / M
$14.00 / M
$0.30 / M
Prices are subject to change. The List Models endpoint (GET /v1/models) returns the current per-token price of every hosted model — read it from your own systems to track changes rather than relying on this table.
Prompt caching is automatic. Cache hits are billed at the Cached Input rate and reported in usage.prompt_tokens_details.cached_tokens. To keep a multi-turn session on its cache, set prompt_cache_key to a stable value per session. See Prompt Caching and Session Affinity.
Authorizations
Authorization
string
header
required
Relace API key Authorization header using the Bearer scheme.
Body
application/json
OpenAI-compatible chat completions request
OpenAI-compatible request. Supported sampling parameters vary slightly by model.
model
string
required
ID of the hosted model to use, e.g. deepseek-ai/DeepSeek-V4.1-Flash, deepseek-ai/DeepSeek-V4-Flash-0731 or moonshotai/kimi-k3.
messages
object[]
required
The conversation so far, as OpenAI-format message objects with role and content.
stream
boolean
If true, tokens are sent as server-sent events as they are generated. Token usage is always reported in the final chunk of the stream.
max_tokens
integer
Maximum number of tokens to generate. Reasoning tokens count toward this limit, so set a generous budget.
temperature
number
Sampling temperature. Higher values make output more random.
top_p
number
Nucleus sampling: only tokens within the top top_p probability mass are considered.
top_k
integer
Only the top_k most likely tokens are considered at each step.
stop
string[]
Up to 4 sequences at which generation stops.
frequency_penalty
number
Penalizes tokens by how often they have appeared so far. Range -2 to 2.
presence_penalty
number
Penalizes tokens that have appeared at all so far. Range -2 to 2.
repetition_penalty
number
Multiplicative penalty on repeated tokens. Values above 1 discourage repetition.
tools
object[]
OpenAI-format function tool definitions the model may call.
tool_choice
any
Controls tool use: none, auto, required, or a specific tool.
response_format
object
Set to {"type": "json_object"} for JSON mode. Kimi K3 only.
prompt_cache_key
string
Cache affinity key. Requests with the same key are served by the same server, improving cache hit rates for multi-turn sessions. Use a stable value per conversation or session. Compatible with OpenAI's parameter of the same name.
Maximum string length: 512
Response
Chat completion generated
id
string
Unique identifier for the completion
object
string
Always chat.completion
created
integer
Unix timestamp of when the completion was created
model
string
The model that served the request
choices
object[]
The generated completions
Show child attributes
usage
object
Token usage information for the request
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Relace","colors":{"primary":"#0066FF","light":"#4D94FF","dark":"#0047B3"},"logo":{"light":"https://mintcdn.com/relace/db9WpuNCcZDHVmZO/logo/light.svg?fit=max\u0026auto=format\u0026n=db9WpuNCcZDHVmZO\u0026q=85\u0026s=8fb6212c3f7e36d063d878a98d7cff90","dark":"https://mintcdn.com/relace/db9WpuNCcZDHVmZO/logo/dark.svg?fit=max\u0026auto=format\u0026n=db9WpuNCcZDHVmZO\u0026q=85\u0026s=978d07312f6ac13f58c22aaa151579ea","href":"https://relace.ai"},"favicon":"https://mintcdn.com/relace/s7F5Z9LGe0g03FCB/favicon.svg?fit=max\u0026auto=format\u0026n=s7F5Z9LGe0g03FCB\u0026q=85\u0026s=b1aef1a2a6e6df815b78fc4d767560ef","navbar":{"links":[{"href":"mailto:info@relace.ai","label":"Support"}],"primary":{"type":"button","label":"Playground","href":"https://app.relace.ai"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/relace-ai"}},"integrations":{"posthog":{"apiKey":"phc_guqCHgvq8r5z5YETZZ5q6394qFrzl7M7W516jUCklUq","sessionRecording":true}},"contextual":{"options":["copy"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"relace","hasAudioNarration":false,"actualSubdomain":"relace","customDomains":["docs.relace.ai"],"gitSource":{"type":"github","owner":"squack-io","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af36054be16eed08391ff47","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API Reference","count":8},{"language":"default","tag":"Documentation","count":8},{"language":"default","tag":"Model Guides","count":5},{"language":"default","tag":"Open Models","count":4},{"language":"default","tag":"Relace Models","count":3},{"language":"default","tag":"Instant Apply","count":3},{"language":"default","tag":"General","count":2},{"language":"default","tag":"Agents","count":2},{"language":"default","tag":"Fast Agentic Search","count":2},{"language":"default","tag":"Guides","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":false},"customCss":[],"page":{"pagePath":"api-reference/open-models/chat-completions","slug":"/api-reference/open-models/chat-completions","pageMetadata":{"title":"Chat Completions","openapi":"POST /v1/chat/completions","description":"Send an OpenAI-compatible chat completions request to a Relace-hosted model.","href":"/api-reference/open-models/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: \"Send an OpenAI-compatible chat completions request to a Relace-hosted model.\"\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`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Note,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`OpenAI-compatible endpoint for open-weights models hosted on Relace infrastructure. You can also use this by pointing any OpenAI SDK at `,_jsx(_components.code,{children:`https://models.relace.ai/v1`}),` with your Relace API key.`]}),`\n`,_jsx(Heading,{level:`2`,id:`models`,children:`Models`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Model`}),_jsxs(_components.th,{children:[_jsx(_components.code,{children:`model`}),` ID`]}),_jsx(_components.th,{children:`Context`}),_jsx(_components.th,{children:`Input`}),_jsx(_components.th,{children:`Output`}),_jsx(_components.th,{children:`Cached Input`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`DeepSeek V4 Flash 0423`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`deepseek-ai/DeepSeek-V4-Flash-0423`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.0277 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$1.28 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.0277 / M`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`DeepSeek V4 Flash 0731`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`deepseek-ai/DeepSeek-V4-Flash-0731`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.07 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.14 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.014 / M`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`DeepSeek V4 Pro 0423 (Preview)`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`deepseek-ai/DeepSeek-V4-Pro`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.45 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$3.00 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.09 / M`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`DeepSeek V4 Pro 0813`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`deepseek-ai/DeepSeek-V4-Pro-0813`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.50 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$2.00 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.05 / M`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`DeepSeek V4.1 Flash`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`deepseek-ai/DeepSeek-V4.1-Flash`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.20 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.60 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.008 / M`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`DeepSeek V4.1 Flash 1017`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`deepseek-ai/DeepSeek-V4.1-Flash-1017`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.20 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.60 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.008 / M`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`GLM 5.2`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`z-ai/glm-5.2`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.40 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$4.00 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.08 / M`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`GLM 5.3`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`z-ai/glm-5.3`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.75 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$2.40 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.075 / M`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`GLM 5.3 Flash`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`z-ai/glm-5.3-flash`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.075 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.50 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.0075 / M`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Kimi K3`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`moonshotai/kimi-k3`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$2.00 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$14.00 / M`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`$0.30 / M`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Prices are subject to change. The `,_jsx(_components.a,{href:`/api-reference/open-models/list-models`,children:`List Models`}),` endpoint (`,_jsx(_components.code,{children:`GET /v1/models`}),`) returns the current per-token price of every hosted model — read it from your own systems to track changes rather than relying on this table.`]})}),`\n`,_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/docs/open-models/quickstart`,children:`Open Models guide`}),` for SDK examples and streaming.`]}),`\n`,_jsx(Heading,{level:`2`,id:`prompt-caching`,children:`Prompt Caching`}),`\n`,_jsxs(_components.p,{children:[`Prompt caching is automatic. Cache hits are billed at the Cached Input rate and reported in `,_jsx(_components.code,{children:`usage.prompt_tokens_details.cached_tokens`}),`. To keep a multi-turn session on its cache, set `,_jsx(_components.code,{children:`prompt_cache_key`}),` to a stable value per session. See `,_jsx(_components.a,{href:`/docs/open-models/quickstart#prompt-caching-and-session-affinity`,children:`Prompt Caching and Session Affinity`}),`.`]})]})}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":"Chat Completions","openapi":"POST /v1/chat/completions","description":"Send an OpenAI-compatible chat completions request to a Relace-hosted model.","href":"/api-reference/open-models/chat-completions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Models","slug":"models","depth":2,"children":[]},{"title":"Prompt Caching","slug":"prompt-caching","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Send an OpenAI-compatible chat completions request to a Relace-hosted model.","servers":["5f550b1a-97bc-4101-9740-e120819b3839"],"requestBody":"2b79e09f-288f-498e-b667-8c1f7fdb0166","responses":{"200":"2c8b4f8e-8024-4e38-a3aa-5e1f64e07af3","400":"c547c01a-3019-4135-af75-dda43b0ba256","401":"20c76ba8-2596-438f-a1a7-3f612a1175bc","402":"ecfa1d17-8906-4790-8b92-730405d32b42","404":"d95a7daa-2a28-4aa2-a3b1-8f6470d9694f","429":"40e63a03-b6aa-44ad-95df-f1cad1719747","500":"5352fd2f-9937-4b09-8690-816dc7522eeb","502":"61d1cf51-732b-4f8d-8d63-b833ba025f5f","503":"9b406764-e606-44c1-a433-95761a75e792","504":"d4557c9d-7adb-4201-a492-b7ee081521e0"},"method":"post","type":"path","security":["48042cb2-e5de-4606-be75-11f4f8c4ac25"],"path":"/v1/chat/completions","baseUrlOptions":["https://models.relace.ai"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"description":"OpenAI-compatible chat completions request","required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","description":"ID of the hosted model to use, e.g. `deepseek-ai/DeepSeek-V4.1-Flash`, `deepseek-ai/DeepSeek-V4-Flash-0731` or `moonshotai/kimi-k3`.","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"messages":{"type":"array","items":{"type":"object","uniqueKey":"messages.items.[INDEX]","typeLabel":"object"},"description":"The conversation so far, as OpenAI-format message objects with `role` and `content`.","isRequired":true,"uniqueKey":"messages","typeLabel":"object[]"},"stream":{"type":"boolean","description":"If true, tokens are sent as server-sent events as they are generated. Token usage is always reported in the final chunk of the stream.","uniqueKey":"stream","typeLabel":"boolean"},"max_tokens":{"type":"integer","description":"Maximum number of tokens to generate. Reasoning tokens count toward this limit, so set a generous budget.","uniqueKey":"max_tokens","typeLabel":"integer"},"temperature":{"type":"number","description":"Sampling temperature. Higher values make output more random.","uniqueKey":"temperature","typeLabel":"number"},"top_p":{"type":"number","description":"Nucleus sampling: only tokens within the top `top_p` probability mass are considered.","uniqueKey":"top_p","typeLabel":"number"},"top_k":{"type":"integer","description":"Only the `top_k` most likely tokens are considered at each step.","uniqueKey":"top_k","typeLabel":"integer"},"stop":{"type":"array","items":{"type":"string","uniqueKey":"stop.items.[INDEX]","typeLabel":"string"},"description":"Up to 4 sequences at which generation stops.","uniqueKey":"stop","typeLabel":"string[]"},"frequency_penalty":{"type":"number","description":"Penalizes tokens by how often they have appeared so far. Range -2 to 2.","uniqueKey":"frequency_penalty","typeLabel":"number"},"presence_penalty":{"type":"number","description":"Penalizes tokens that have appeared at all so far. Range -2 to 2.","uniqueKey":"presence_penalty","typeLabel":"number"},"repetition_penalty":{"type":"number","description":"Multiplicative penalty on repeated tokens. Values above 1 discourage repetition.","uniqueKey":"repetition_penalty","typeLabel":"number"},"tools":{"type":"array","items":{"type":"object","uniqueKey":"tools.items.[INDEX]","typeLabel":"object"},"description":"OpenAI-format function tool definitions the model may call.","uniqueKey":"tools","typeLabel":"object[]"},"tool_choice":{"description":"Controls tool use: `none`, `auto`, `required`, or a specific tool.","uniqueKey":"tool_choice","typeLabel":"any"},"response_format":{"type":"object","description":"Set to `{\"type\": \"json_object\"}` for JSON mode. Kimi K3 only.","uniqueKey":"response_format","typeLabel":"object"},"prompt_cache_key":{"type":"string","maxLength":512,"description":"Cache affinity key. Requests with the same key are served by the same server, improving cache hit rates for multi-turn sessions. Use a stable value per conversation or session. Compatible with OpenAI's parameter of the same name.","uniqueKey":"prompt_cache_key","typeLabel":"string"}},"additionalProperties":true,"description":"OpenAI-compatible request. Supported sampling parameters vary slightly by model.","uniqueKey":"","typeLabel":"object"},"example":{"model":"deepseek-ai/DeepSeek-V4-Flash-0731","messages":[{"role":"user","content":"Write a binary search in Python."}],"stream":false},"examples":{"Example":{"title":"Example","value":{"model":"deepseek-ai/DeepSeek-V4-Flash-0731","messages":[{"role":"user","content":"Write a binary search in Python."}],"stream":false}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"2c8b4f8e-8024-4e38-a3aa-5e1f64e07af3":{"description":"Chat completion generated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the completion","uniqueKey":"id","typeLabel":"string"},"object":{"type":"string","description":"Always `chat.completion`","uniqueKey":"object","typeLabel":"string"},"created":{"type":"integer","description":"Unix timestamp of when the completion was created","uniqueKey":"created","typeLabel":"integer"},"model":{"type":"string","description":"The model that served the request","uniqueKey":"model","typeLabel":"string"},"choices":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","uniqueKey":"choices.items.[INDEX].index","typeLabel":"integer"},"message":{"type":"object","description":"The generated message, with `role` and `content` (and `tool_calls` when the model called tools)","uniqueKey":"choices.items.[INDEX].message","typeLabel":"object"},"finish_reason":{"type":"string","description":"Why generation stopped, e.g. `stop`, `length`, or `tool_calls`","uniqueKey":"choices.items.[INDEX].finish_reason","typeLabel":"string"}},"uniqueKey":"choices.items.[INDEX]","typeLabel":"object"},"description":"The generated completions","uniqueKey":"choices","typeLabel":"object[]"},"usage":{"type":"object","properties":{"prompt_tokens":{"type":"integer","description":"Number of tokens in the prompt","uniqueKey":"usage.prompt_tokens","typeLabel":"integer"},"completion_tokens":{"type":"integer","description":"Number of tokens in the completion","uniqueKey":"usage.completion_tokens","typeLabel":"integer"},"total_tokens":{"type":"integer","description":"Total number of tokens used","uniqueKey":"usage.total_tokens","typeLabel":"integer"}},"description":"Token usage information for the request","uniqueKey":"usage","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","object":"\u003cstring>","created":123,"model":"\u003cstring>","choices":[{"index":123,"message":{},"finish_reason":"\u003cstring>"}],"usage":{"prompt_tokens":123,"completion_tokens":123,"total_tokens":123}}}},"exampleType":"generated"},"text/event-stream":{"schema":{"type":"string","description":"Stream of chat completion chunks in the OpenAI streaming format. Token usage is reported in the final chunk.","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"}},"exampleType":"generated"},"c547c01a-3019-4135-af75-dda43b0ba256":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","description":"Error message","example":"Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"OpenAI error type","enum":["invalid_request_error","authentication_error","insufficient_quota","rate_limit_error","api_error"],"example":"rate_limit_error","uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"param":{"oneOf":[{"type":"string","description":"Offending request parameter, when known","example":null,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending request parameter, when known","example":null,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Always null on Relace-authored errors","example":null,"uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Always null on Relace-authored errors","example":null,"uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.","type":"rate_limit_error","param":null,"code":null}}}},"exampleType":"generated"}},"exampleType":"generated"},"20c76ba8-2596-438f-a1a7-3f612a1175bc":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","description":"Error message","example":"Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"OpenAI error type","enum":["invalid_request_error","authentication_error","insufficient_quota","rate_limit_error","api_error"],"example":"rate_limit_error","uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"param":{"oneOf":[{"type":"string","description":"Offending request parameter, when known","example":null,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending request parameter, when known","example":null,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Always null on Relace-authored errors","example":null,"uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Always null on Relace-authored errors","example":null,"uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.","type":"rate_limit_error","param":null,"code":null}}}},"exampleType":"generated"}},"exampleType":"generated"},"ecfa1d17-8906-4790-8b92-730405d32b42":{"description":"Out of credits, or no payment method on the account","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","description":"Error message","example":"Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"OpenAI error type","enum":["invalid_request_error","authentication_error","insufficient_quota","rate_limit_error","api_error"],"example":"rate_limit_error","uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"param":{"oneOf":[{"type":"string","description":"Offending request parameter, when known","example":null,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending request parameter, when known","example":null,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Always null on Relace-authored errors","example":null,"uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Always null on Relace-authored errors","example":null,"uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.","type":"rate_limit_error","param":null,"code":null}}}},"exampleType":"generated"}},"exampleType":"generated"},"d95a7daa-2a28-4aa2-a3b1-8f6470d9694f":{"description":"Route not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","description":"Error message","example":"Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"OpenAI error type","enum":["invalid_request_error","authentication_error","insufficient_quota","rate_limit_error","api_error"],"example":"rate_limit_error","uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"param":{"oneOf":[{"type":"string","description":"Offending request parameter, when known","example":null,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending request parameter, when known","example":null,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Always null on Relace-authored errors","example":null,"uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Always null on Relace-authored errors","example":null,"uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.","type":"rate_limit_error","param":null,"code":null}}}},"exampleType":"generated"}},"exampleType":"generated"},"40e63a03-b6aa-44ad-95df-f1cad1719747":{"description":"Rate limit exceeded, or the model is at capacity","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","description":"Error message","example":"Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"OpenAI error type","enum":["invalid_request_error","authentication_error","insufficient_quota","rate_limit_error","api_error"],"example":"rate_limit_error","uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"param":{"oneOf":[{"type":"string","description":"Offending request parameter, when known","example":null,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending request parameter, when known","example":null,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Always null on Relace-authored errors","example":null,"uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Always null on Relace-authored errors","example":null,"uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.","type":"rate_limit_error","param":null,"code":null}}}},"exampleType":"generated"}},"exampleType":"generated"},"5352fd2f-9937-4b09-8690-816dc7522eeb":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","description":"Error message","example":"Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"OpenAI error type","enum":["invalid_request_error","authentication_error","insufficient_quota","rate_limit_error","api_error"],"example":"rate_limit_error","uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"param":{"oneOf":[{"type":"string","description":"Offending request parameter, when known","example":null,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending request parameter, when known","example":null,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Always null on Relace-authored errors","example":null,"uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Always null on Relace-authored errors","example":null,"uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.","type":"rate_limit_error","param":null,"code":null}}}},"exampleType":"generated"}},"exampleType":"generated"},"61d1cf51-732b-4f8d-8d63-b833ba025f5f":{"description":"Model server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","description":"Error message","example":"Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"OpenAI error type","enum":["invalid_request_error","authentication_error","insufficient_quota","rate_limit_error","api_error"],"example":"rate_limit_error","uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"param":{"oneOf":[{"type":"string","description":"Offending request parameter, when known","example":null,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending request parameter, when known","example":null,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Always null on Relace-authored errors","example":null,"uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Always null on Relace-authored errors","example":null,"uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.","type":"rate_limit_error","param":null,"code":null}}}},"exampleType":"generated"}},"exampleType":"generated"},"9b406764-e606-44c1-a433-95761a75e792":{"description":"Model temporarily unavailable","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","description":"Error message","example":"Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"OpenAI error type","enum":["invalid_request_error","authentication_error","insufficient_quota","rate_limit_error","api_error"],"example":"rate_limit_error","uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"param":{"oneOf":[{"type":"string","description":"Offending request parameter, when known","example":null,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending request parameter, when known","example":null,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Always null on Relace-authored errors","example":null,"uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Always null on Relace-authored errors","example":null,"uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.","type":"rate_limit_error","param":null,"code":null}}}},"exampleType":"generated"}},"exampleType":"generated"},"d4557c9d-7adb-4201-a492-b7ee081521e0":{"description":"Request to the model timed out","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","description":"Error message","example":"Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"OpenAI error type","enum":["invalid_request_error","authentication_error","insufficient_quota","rate_limit_error","api_error"],"example":"rate_limit_error","uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"param":{"oneOf":[{"type":"string","description":"Offending request parameter, when known","example":null,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending request parameter, when known","example":null,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Always null on Relace-authored errors","example":null,"uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Always null on Relace-authored errors","example":null,"uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Rate limit exceeded. Retry after the Retry-After interval, or contact support to raise your limits.","type":"rate_limit_error","param":null,"code":null}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"48042cb2-e5de-4606-be75-11f4f8c4ac25":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Relace API key Authorization header using the Bearer scheme.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"5f550b1a-97bc-4101-9740-e120819b3839":{"url":"https://models.relace.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Relace API key Authorization header using the Bearer scheme.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Relace API key Authorization header using the Bearer scheme.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"relace","siteName":"Relace","title":"Chat Completions - Relace","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T05:22:07.794Z","originalFileLocation":"api-reference/open-models/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=\"system\"}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=\"Send an OpenAI-compatible chat completions request to a Relace-hosted model.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Relace\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/relace/NSKygUkcOPJ0dXD5/_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/relace/NSKygUkcOPJ0dXD5/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/relace/NSKygUkcOPJ0dXD5/_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/relace/NSKygUkcOPJ0dXD5/_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/relace/NSKygUkcOPJ0dXD5/_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/relace/NSKygUkcOPJ0dXD5/_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/relace/NSKygUkcOPJ0dXD5/_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/relace/NSKygUkcOPJ0dXD5/_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/relace/NSKygUkcOPJ0dXD5/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Chat Completions - Relace\">\u003cmeta data-mint-head property=\"og:description\" content=\"Send an OpenAI-compatible chat completions request to a Relace-hosted model.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Relace\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.relace.ai/api-reference/open-models/chat-completions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://relace.mintlify.site/_mintlify/api/og/v2?division=Open+Models\u0026amp;title=Chat+Completions\u0026amp;description=Send+an+OpenAI-compatible+chat+completions+request+to+a+Relace-hosted+model.\u0026amp;theme=57c4eb56dcaa832310d126ad\u0026amp;signature=de1e06ba539efb298fb8568bb784ecdf110e8a083644c0d2558e7e23493877ff\">\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=\"Chat Completions - Relace\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Send an OpenAI-compatible chat completions request to a Relace-hosted model.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://relace.mintlify.site/_mintlify/api/og/v2?division=Open+Models\u0026amp;title=Chat+Completions\u0026amp;description=Send+an+OpenAI-compatible+chat+completions+request+to+a+Relace-hosted+model.\u0026amp;theme=57c4eb56dcaa832310d126ad\u0026amp;signature=de1e06ba539efb298fb8568bb784ecdf110e8a083644c0d2558e7e23493877ff\">\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/relace/NSKygUkcOPJ0dXD5/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Relace\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0066FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.relace.ai/api-reference/open-models/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/open-models/chat-completions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.relace.ai/#organization\",\"name\":\"Relace\",\"url\":\"https://docs.relace.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/relace/db9WpuNCcZDHVmZO/logo/light.svg?fit=max\u0026auto=format\u0026n=db9WpuNCcZDHVmZO\u0026q=85\u0026s=8fb6212c3f7e36d063d878a98d7cff90\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.relace.ai#website\",\"name\":\"Relace\",\"url\":\"https://docs.relace.ai\",\"publisher\":{\"@id\":\"https://docs.relace.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.relace.ai/api-reference/open-models/chat-completions#webpage\",\"url\":\"https://docs.relace.ai/api-reference/open-models/chat-completions\",\"name\":\"Chat Completions\",\"description\":\"Send an OpenAI-compatible chat completions request to a Relace-hosted model.\",\"dateModified\":\"2026-10-23T05:22:07.794Z\",\"isPartOf\":{\"@id\":\"https://docs.relace.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.relace.ai/api-reference/open-models/chat-completions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.relace.ai/api-reference/open-models/chat-completions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Relace\",\"item\":\"https://docs.relace.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Chat Completions\",\"item\":\"https://docs.relace.ai/api-reference/open-models/chat-completions\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.relace.ai/api-reference/open-models/chat-completions#apireference\",\"headline\":\"Chat Completions\",\"name\":\"Chat Completions\",\"description\":\"Send an OpenAI-compatible chat completions request to a Relace-hosted model.\",\"url\":\"https://docs.relace.ai/api-reference/open-models/chat-completions\",\"mainEntityOfPage\":{\"@id\":\"https://docs.relace.ai/api-reference/open-models/chat-completions#webpage\"},\"dateModified\":\"2026-10-23T05:22:07.794Z\",\"publisher\":{\"@id\":\"https://docs.relace.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.relace.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Relace\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Relace\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/open-models/chat-completions.md","siteName":"Relace","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/docs/introduction"}]},{"anchor":"API Reference","icon":"square-terminal","groups":[{"group":"General","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Errors","href":"/api-reference/errors"}]},{"group":"Relace Models","pages":[{"title":"Compact Trace","openapi":"POST /v1/code/compact","href":"/api-reference/compact/compact"},{"title":"Apply Code","openapi":"POST /v1/code/apply","href":"/api-reference/instant-apply/apply"},{"title":"Search Code","openapi":"POST /v1/search/chat/completions","description":"Run the Fast Agentic Search model (`relace-search`) one turn at a time through an OpenAI-compatible chat completions request. You supply the agent harness: the search tools and the code that executes them.","href":"/api-reference/fast-agentic-search/search"}]},{"group":"Open Models","pages":[{"title":"Chat Completions","openapi":"POST /v1/chat/completions","href":"/api-reference/open-models/chat-completions"},{"title":"Messages","openapi":"POST /v1/messages","description":"Send an Anthropic-compatible Messages request to a Relace-hosted model.","href":"/api-reference/open-models/messages"},{"title":"List Models","openapi":"GET /v1/models","href":"/api-reference/open-models/list-models"}]}]}]},"basePath":"","title":"Chat Completions - Relace","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B6WFFOBL.js","utils-BN5um1KA.js","cloneDeep-C3md22mN.js","_Uint8Array-DLlL8L26.js","isObject-FP1Yky1u.js","utils-BSmbkXJR.js","addUniqueKeysToSchema-2tqcVnUE.js","snippetPresets-CtWfvr2J.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DkKHBy30.js","isEqual-O3q7y6pq.js","usePlaygroundInputsStore-Brc5H9UJ.js","shallow-C4L4xvbs.js","getApiPlaygroundDisplay-2bxyq_aI.js","CodeSnippet-BJu8ddd5.js","CodeSnippets-dazWmoqB.js","Page-CnLhKuUV.js","getPastedJson-Chy3Qa1S.js","icon-CyO7h3jh.js","MethodPill-Dle0_91v.js","DuplicateIcon-CVvWAf4a.js","createIcon-Di07A27B.js","DynamicMarkdown-C4w9kavL.js","SectionHeading-XiBebVYC.js","axios-vUo_bRtp.js","Markdown-DTeL0SpS.js","dist-OCScizqf.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-KcneGfMY.js"]}