Create Chat Completion
POSThttps://api.deepseek.com/chat/completionsCreates a model response for the given chat conversation.
Request
Header Params
Content-Type
string
required
Example:
application/json
Authorization
string
required
Example:
Bearer {{API_KEY}}
Body Params application/json
messages
array [object {2}]
required
content
string
required
role
string
required
model
string
required
frequency_penalty
integer
required
max_tokens
integer
required
presence_penalty
integer
required
response_format
object
required
type
string
required
stop
null
required
stream
boolean
required
stream_options
null
required
temperature
integer
required
top_p
integer
required
tools
null
required
tool_choice
string
required
logprobs
boolean
required
top_logprobs
null
required
Example
{
"messages": [
{
"content": "You are a helpful assistant",
"role": "system"
},
{
"content": "Hi",
"role": "user"
}
],
"model": "deepseek-chat",
"frequency_penalty": 0,
"max_tokens": 2048,
"presence_penalty": 0,
"response_format": {
"type": "text"
},
"stop": null,
"stream": false,
"stream_options": null,
"temperature": 1,
"top_p": 1,
"tools": null,
"tool_choice": "none",
"logprobs": false,
"top_logprobs": null
}Request samples
Responses
Success(200)
Success(200)
HTTP Code: 200
Content Type : JSONapplication/json
OK, returns a chat completion object
Data Schema
id
string
required
choices
array [object {4}]
required
finish_reason
string
optional
index
integer
optional
message
object
optional
logprobs
object
optional
created
integer
required
model
string
required
system_fingerprint
string
required
object
string
required
usage
object
required
completion_tokens
integer
required
prompt_tokens
integer
required
prompt_cache_hit_tokens
integer
required
prompt_cache_miss_tokens
integer
required
total_tokens
integer
required
completion_tokens_details
object
required
Example
Success
{
"id": "string",
"choices": [
{
"finish_reason": "stop",
"index": 0,
"message": {
"content": "string",
"reasoning_content": "string",
"tool_calls": [
{
"id": "string",
"type": "function",
"function": {
"name": "string",
"arguments": "string"
}
}
],
"role": "assistant"
},
"logprobs": {
"content": [
{
"token": "string",
"logprob": 0,
"bytes": [
0
],
"top_logprobs": [
{
"token": "string",
"logprob": 0,
"bytes": [
0
]
}
]
}
]
}
}
],
"created": 0,
"model": "string",
"system_fingerprint": "string",
"object": "chat.completion",
"usage": {
"completion_tokens": 0,
"prompt_tokens": 0,
"prompt_cache_hit_tokens": 0,
"prompt_cache_miss_tokens": 0,
"total_tokens": 0,
"completion_tokens_details": {
"reasoning_tokens": 0
}
}
}Last modified: 4 days ago