艾可API中文文档
  1. 接口
艾可API中文文档
  • 艾可API文档站
    • 艾可API站点介绍
      • 艾可API介绍
      • 常见问题解答
      • 令牌分组详细表格
      • 计费规则说明
      • 站点快速上手教程
    • claude code 使用教程
      • Windows
      • Linux
      • Mac os
      • Vscode 及其他IDE
      • 在RooCode以及KiloCode使用ClaudeCode
    • Codex使用教程
      • WIndows
      • Linux
      • Mac os
      • VScode 及其他IDE
    • Gemini使用教程
      • Windows
      • Linux
      • Mac os
    • 好用的配置工具及软件
      • CC SWITCH
      • rooocde插件 (推荐使用-配置简单)
      • cherry studio
      • 酒馆PC端配置教程
    • 示例代码
      • python
        • 01 OpenAI-Python示例代码
        • 02 Claude-Python示例代码
        • 03 OpenAI-image-Python示例代码
        • 04 Gemini-Python示例代码
        • 05 Rerank-python示例代码
        • 06 Python分析文件代码示例
        • 07 whisper-1-Python实力代码
        • 08 Python其他示例
      • Java
        • 01 OpenAI-Java示例代码
        • 02 Claude-Java示例代码
    • 接口
      • Anthropic 对话格式(Messages)
      • Cohere 重排序格式(Rerank)
      • Deepseek reasoning 对话格式(类Chat Completions)
      • Jina AI 重排序格式(Rerank)
      • Midjourney 图像格式(Midjourney Proxy/Midjourney Proxy Plus)
      • OpenAI 音频格式
      • OpenAI 对话格式(Chat Completions)
      • OpenAI 嵌入格式(Embeddings)
      • OpenAI 图像格式(Image)
      • OpenAI 实时对话接口
      • OpenAI 响应格式(Responses)
      • Suno 音乐格式(Music)
      • Xinference 重排序格式(Rerank)
  1. 接口

Deepseek reasoning 对话格式(类Chat Completions)

1.艾可AI官方客服#

---------------【点击添加微信客服不定期福利免费领】-------------------------
如果显示添加频繁请手动搜索微信号进行添加:
点击复制微信号:2236094129

Deepseek reasoning 对话格式(类Chat Completions)#

!!! info "官方文档"
推理模型 (deepseek-reasoner)

📝 简介#

Deepseek-reasoner 是 DeepSeek 推出的推理模型。在输出最终回答之前,模型会先输出一段思维链内容,以提升最终答案的准确性。API 向用户开放 deepseek-reasoner 思维链的内容,以供用户查看、展示、蒸馏使用。

💡 请求示例#

基础文本对话 ✅#

响应示例:
{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "deepseek-reasoner",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "reasoning_content": "让我一步步思考:\n1. 我们需要比较9.11和9.8的大小\n2. 两个数都是小数,我们可以直接比较\n3. 9.8 = 9.80\n4. 9.11 < 9.80\n5. 所以9.8更大",
      "content": "9.8 is greater than 9.11."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 15,
    "total_tokens": 25
  }
}

流式响应 ✅#

流式响应示例:
{"id":"chatcmpl-123","object":"chat.completion.chunk","created":1694268190,"model":"deepseek-reasoner","choices":[{"index":0,"delta":{"role":"assistant","reasoning_content":"让我"},"finish_reason":null}]}

{"id":"chatcmpl-123","object":"chat.completion.chunk","created":1694268190,"model":"deepseek-reasoner","choices":[{"index":0,"delta":{"reasoning_content":"一步步"},"finish_reason":null}]}

{"id":"chatcmpl-123","object":"chat.completion.chunk","created":1694268190,"model":"deepseek-reasoner","choices":[{"index":0,"delta":{"reasoning_content":"思考:"},"finish_reason":null}]}

// ... 更多思维链内容 ...

{"id":"chatcmpl-123","object":"chat.completion.chunk","created":1694268190,"model":"deepseek-reasoner","choices":[{"index":0,"delta":{"content":"9.8"},"finish_reason":null}]}

{"id":"chatcmpl-123","object":"chat.completion.chunk","created":1694268190,"model":"deepseek-reasoner","choices":[{"index":0,"delta":{"content":" is greater"},"finish_reason":null}]}

// ... 更多最终答案内容 ...

{"id":"chatcmpl-123","object":"chat.completion.chunk","created":1694268190,"model":"deepseek-reasoner","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

📮 请求#

端点#

POST /v1/chat/completions

鉴权方法#

在请求头中包含以下内容进行 API 密钥认证:
Authorization: Bearer $NEWAPI_API_KEY
其中 $DEEPSEEK_API_KEY 是您的 API 密钥。

请求体参数#

messages#

类型:数组
必需:是
到目前为止包含对话的消息列表。请注意,如果您在输入的 messages 序列中传入了 reasoning_content,API 会返回 400 错误。

model#

类型:字符串
必需:是
值:deepseek-reasoner
要使用的模型 ID。目前仅支持 deepseek-reasoner。

max_tokens#

类型:整数
必需:否
默认值:4096
最大值:8192
最终回答的最大长度(不含思维链输出)。请注意,思维链的输出最多可以达到 32K tokens。

stream#

类型:布尔值
必需:否
默认值:false
是否使用流式响应。

不支持的参数#

以下参数当前不支持:
temperature
top_p
presence_penalty
frequency_penalty
logprobs
top_logprobs
注意:为了兼容已有软件,设置 temperature、top_p、presence_penalty、frequency_penalty 参数不会报错,但也不会生效。设置 logprobs、top_logprobs 会报错。

支持的功能#

对话补全
对话前缀续写 (Beta)

不支持的功能#

Function Call
Json Output
FIM 补全 (Beta)

📥 响应#

成功响应#

返回一个聊天补全对象,如果请求被流式传输,则返回聊天补全块对象的流式序列。

id#

类型:字符串
说明:响应的唯一标识符

object#

类型:字符串
说明:对象类型,值为 "chat.completion"

created#

类型:整数
说明:响应创建时间戳

model#

类型:字符串
说明:使用的模型名称,值为 "deepseek-reasoner"

choices#

类型:数组
说明:包含生成的回复选项
属性:
index: 选项索引
message: 包含角色、思维链内容和最终回答的消息对象
role: 角色,值为 "assistant"
reasoning_content: 思维链内容
content: 最终回答内容
finish_reason: 完成原因

usage#

类型:对象
说明:token 使用统计
属性:
prompt_tokens: 提示使用的 token 数
completion_tokens: 补全使用的 token 数
total_tokens: 总 token 数

📝 上下文拼接说明#

在每一轮对话过程中,模型会输出思维链内容(reasoning_content)和最终回答(content)。在下一轮对话中,之前轮输出的思维链内容不会被拼接到上下文中,如下图所示:
Deepseek reasoning 上下文拼接示意图
!!! warning "注意"
如果您在输入的 messages 序列中,传入了reasoning_content,API 会返回 400 错误。因此,请删除 API 响应中的 reasoning_content 字段,再发起 API 请求,方法如下方使用示例所示。
使用示例:
流式响应示例:
修改于 2025-12-22 12:52:10
上一页
Cohere 重排序格式(Rerank)
下一页
Jina AI 重排序格式(Rerank)
Built with