Skip to main content
POST
Create chat completion

Authorizations

Authorization
string
header
required

API key for programmatic access (Authorization: Bearer sk-<api_key>)

Body

application/json
messages
object[]
required
model
string
required
frequency_penalty
number<float> | null
max_tokens
integer<int64> | null
n
integer<int64> | null
presence_penalty
number<float> | null
stop

OpenAI stop accepts either a single string or an array of strings.

stream
boolean | null
temperature
number<float> | null
top_p
number<float> | null
{key}
any

Response

Completion generated successfully

choices
object[]
required
created
integer<int64>
required
id
string
required
model
string
required
object
string
required
usage
object
required

Usage for chat/completions endpoints. Serializes as prompt_tokens, completion_tokens, prompt_tokens_details, completion_tokens_details, total_tokens.

{key}
any

Unknown top-level fields from the provider (e.g. system_fingerprint, prompt_logprobs). Re-emitted when serializing so we do not drop them.