Skip to main content
POST
Chat completion

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
enum<string>
required

The model ID used for completion.

Available options:
claude-sonnet-4-6,
claude-sonnet-4-5-20250929,
claude-sonnet-4-20250514,
claude-opus-4-6,
claude-opus-4-5-20251101,
claude-opus-4-1-20250805,
claude-opus-4-20250514,
claude-haiku-4-5-20251001,
claude-3-7-sonnet-20250219,
claude-3-5-sonnet-20241022,
gpt-5-4,
gpt-5-3-codex,
gpt-5-2,
gpt-5-2-chat,
gpt-5-2-chat-latest,
gpt-5-2-codex,
gpt-5-1,
gpt-5-1-chat,
gpt-5-1-chat-latest,
gpt-5-1-codex-mini,
gpt-5,
gpt-5-chat-latest,
gpt-5-pro,
gpt-5-codex,
gpt-5-codex-high,
gpt-5-codex-low,
gpt-5-mini,
gpt-5-nano,
gpt-4o,
gpt-4o-mini,
gpt-4-1,
gpt-4,
deepseek-v3-2-speciale,
deepseek-v3-2,
deepseek-v3-2-exp,
deepseek-v3-2-251201,
deepseek-v3-1-terminus,
deepseek-v3-1,
deepseek-v3,
qwen3.5-397b-a17b,
qwen3-coder-next,
qwen3-coder,
qwen3-235b-a22b,
qwen3-32b,
qwen3-14b,
qwen2.5-72b-instruct,
doubao-seed-2.0-pro,
doubao-seed-2.0-code,
doubao-seed-2.0-lite,
doubao-seed-2.0-mini,
doubao-seed-1-8-251228,
doubao-seed-1-6-flash-250828,
doubao-seed-1-6-251015,
doubao-seed-1-6-lite-251015,
doubao-seed-1-6-vision-250815,
minimax-m2.5,
minimax-m2.1,
kimi-k2.5,
grok-3,
grok-3-mini,
grok-4-fast-reasoning,
grok-4-fast-non-reasoning,
grok-4-1-fast-reasoning,
grok-4-1-fast-non-reasoning,
gemini-3.1-pro-preview,
gemini-3.1-flash-image-preview,
gemini-3-pro-preview,
gemini-3-flash-preview,
gemini-2.5-pro,
gemini-2.5-flash,
gemini-2.0-flash,
glm-4.7
Example:

"claude-sonnet-4-6"

messages
object[]
required

The list of messages that make up the current conversation.

Minimum array length: 1
Example:
max_tokens
integer

Maximum number of tokens to generate in the chat completion.

Required range: x >= 1
temperature
number
default:1

Sampling temperature, from 0 to 2. Higher values make the output more random; lower values make it more deterministic.

Required range: 0 <= x <= 2
Example:

1

top_p
number

Nucleus sampling threshold, as an alternative to temperature.

Required range: 0 <= x <= 1
frequency_penalty
number
default:0

Penalize new tokens based on how often they already appear in the text.

Required range: -2 <= x <= 2
presence_penalty
number
default:0

Penalize new tokens if they have already appeared in the text.

Required range: -2 <= x <= 2
stream
boolean
default:false

If true, partial messages are streamed via server-sent events (SSE).

stop

Up to 4 sequences. The API stops generating further tokens when these sequences appear.

n
integer
default:1

How many completion choices to generate for each input message.

Required range: x >= 1
response_format
object

Specify the format the model must output. Set {"type": "json_object"} to enable JSON mode.

tools
object[]

A list of tools the model can call. Currently only functions are supported as tools.

tool_choice

Controls which tool the model calls, if any.

user
string

A unique identifier representing the end user.

Response

Completion generated successfully

id
string
required
Example:

"chatcmpl-abc123"

object
string
required
Example:

"chat.completion"

created
integer
required

Unix timestamp when the completion was created.

model
string
required
Example:

"claude-sonnet-4-6"

choices
object[]
required
usage
object