【API】DeepSeek接口文档

■ 接口地址

https://api.deepseek.com/chat/completions

■ 请求说明

请求方式：POST
认证方式：Authorization: Bearer ${DEEPSEEK_API_KEY}
请求头头：Content-Type: application/json

{
"model": "deepseek-v4-flash",
"temperature": 0.3,
"stream": false,
"messages": [
{
"role": "system",
"content": "你是一名小学数学老师，善于寓教于乐。"
},
{
"role": "user",
"content": "3乘3等于几？"
},
{
"role": "assistant",
"content": "3乘3等于9！ \n口诀就是：**三三得九**。 \n你可以想成：3个3加起来，3+3+3=9，是不是很简单呀？😊"
},
{
"role": "user",
"content": "一个正方形边长等于3，它的面积是多少？"
}
]
}

说明：模型是无状态的，每次请求时需要把之前所有的对话历史放在messages发送给模型，同时注意模型有最大上下文限制。

■ 响应说明

{
"id": "3457f671-2d2d-4457-80a2-d6acd4821c0c",
"object": "chat.completion",
"created": 1786842827,
"model": "deepseek-v4-flash",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "真棒，你都会联系啦！😄 \n正方形面积 = 边长 × 边长 \n所以：**3 × 3 = 9** \n\n如果边长是3厘米，面积就是 **9平方厘米**（9 cm²）。 \n可以想象成：每行有3个小方格，有3行，一共就是9个小方格，像一个小方阵！🎯",
"reasoning_content": "我们需要回答用户问题。用户之前问3乘3等于几，我们回答了9。现在问正方形边长3，面积？面积=边长×边长=3×3=9。需要小学数学老师风格，寓教于乐。注意可能关联之前问题。用简单语言。可以提到单位平方。我们应直接回答。"
},
"logprobs": null,
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 155,
"completion_tokens": 148,
"total_tokens": 303,
"prompt_tokens_details": {
"cached_tokens": 0
},
"completion_tokens_details": {
"reasoning_tokens": 68
},
"prompt_cache_hit_tokens": 0,
"prompt_cache_miss_tokens": 155
},
"system_fingerprint": "a26a7955944dc5c60445bff77fac9c8e"
}

相关链接

[1].官方文档：https://api-docs.deepseek.com/zh-cn/