导航|地址|刷新
使用 Responses API | DeepSeek API Docs





跳到主要内容




DeepSeek API 文档


中文（中国）
English

中文（中国）

DeepSeek Platform














快速开始

首次调用 API

模型 & 价格

Token 用量计算

限速与隔离

错误码


接入 Agent 工具




API 指南

思考模式

多轮对话

对话前缀续写（Beta）

FIM 补全（Beta）

JSON Output

Tool Calls

上下文硬盘缓存

使用 Responses API

使用 Anthropic API



API 文档



新闻



其它资源


常见问题

更新日志










API 指南

使用 Responses API

本页总览




使用 Responses API


支持的模型


Responses API 目前仅支持 deepseek-v4-flash 模型，暂不支持 deepseek-v4-pro 模型。我们将于 2026 年 8 月初增加对 deepseek-v4-pro 模型的支持。



为了满足大家对 Codex 的需求，我们的 API 新增了对 Responses API 格式的支持，其 base_url 为 https://api.deepseek.com

通过简单的配置，即可在 Codex 中使用 DeepSeek 模型。

将 DeepSeek 模型接入 Codex​

请参考接入 Codex

通过 Responses API 调用 DeepSeek 模型​


# Please install OpenAI SDK first: `pip3 install openai`
from openai import OpenAI

client = OpenAI(api_key="<your DeepSeek API Key>", base_url="https://api.deepseek.com")

response = client.responses.create(
model="deepseek-v4-flash",
instructions="You are a helpful assistant.",
input="Hi, how are you?",
)

print(response.output_text)





流式输出​

设置 stream: true，响应将以语义化的流式 SSE 事件序列返回。每个事件带有表示事件类型的 event 字段和递增的 sequence_number。流以 response.completed / response.incomplete / response.failed 事件结束，没有 data: [DONE] 消息。


stream = client.responses.create(
model="deepseek-v4-flash",
instructions="You are a helpful assistant.",
input="Hi, how are you?",
stream=True,
)

for event in stream:
if event.type=="response.output_text.delta":
print(event.delta, end="")





完整事件列表：

事件	说明
response.created	首个事件；响应已创建，状态为 in_progress
response.in_progress	响应正在生成中
response.output_item.added / response.output_item.done	一个输出 item（reasoning / message / function_call / custom_tool_call / web_search_call）开始 / 完成
response.content_part.added / response.content_part.done	输出 item 中的一个内容块开始 / 完成
response.reasoning_text.delta / response.reasoning_text.done	思维链文本增量 / 完整思维链文本
response.output_text.delta / response.output_text.done	输出文本增量 / 完整输出文本
response.function_call_arguments.delta / response.function_call_arguments.done	Function 调用参数增量 / 完整参数
response.custom_tool_call_input.delta / response.custom_tool_call_input.done	Custom 工具调用（apply_patch）输入增量 / 完整输入
response.web_search_call.in_progress / response.web_search_call.searching / response.web_search_call.completed	服务端联网搜索工具调用的状态更新
response.completed	响应正常完成时的最后一个事件，携带包含 usage 的完整 response 对象
response.incomplete	响应被截断（如达到 max_output_tokens）时的最后一个事件，携带完整 response 对象
response.failed	响应失败时的最后一个事件，携带含 error 详情的完整 response 对象

兼容性明细​

本小节罗列了 DeepSeek API 对 Responses API 的兼容性细节。Responses API 完整格式定义，请参考 OpenAI 官方 API 手册。

顶层请求参数​

参数	支持情况
model	支持。目前仅支持 deepseek-v4-flash（暂不支持 deepseek-v4-pro），见模型 & 价格
input	支持。字符串或输入 item 列表；input 与 instructions 至少传一个
instructions	支持。作为第一条 system 消息
stream	支持
temperature	支持（范围 [0.0, 2.0]；思考模式下不生效）
top_p	支持（思考模式下不生效）
max_output_tokens	支持
top_logprobs	支持（范围 [0, 20]）
tools	部分支持。function / web_search 支持；其他类型忽略，见下方 Tools 表
tool_choice	支持。none / auto / required / 指定某个工具（{"type": "function", "name": ...} 或 {"type": "web_search"} / {"type": "web_search_2025_08_26"}）
reasoning	部分支持。effort 支持；summary 可传入但不生成摘要
text	部分支持。format 完整支持；verbosity 可传入但不生效
user	支持。参考限速与用户隔离
parallel_tool_calls	忽略（并行工具调用始终开启）
max_tool_calls	忽略
previous_response_id	不支持（无状态 API）
conversation	不支持（无状态 API）
store	不支持。响应中恒为 store: false
background	不支持
metadata	不支持
include	不支持
prompt	不支持
truncation	不支持。输入超出上下文窗口时返回 400 错误
service_tier	不支持
safety_identifier	不支持
prompt_cache_key / prompt_cache_retention	不支持。上下文缓存自动管理，见上下文硬盘缓存
context_management	不支持
stream_options	不支持

不支持的参数会被静默忽略、不会报错，因此现有的 Responses API 客户端无需修改即可接入。

输入 Items​

类型	支持情况
message	支持。角色支持 user / assistant / system / developer（developer 视同 system）；content 支持字符串和 input_text / output_text 内容块。不支持图片、文件输入（input_image 内容块不会报错，但会被替换为占位文本）
function_call	支持。归并到相邻 assistant 消息
function_call_output	支持
reasoning	支持。明文 content 归并到相邻 assistant 消息；summary、encrypted_content 不支持
web_search_call	支持。原样回传即可，服务端自动恢复搜索结果
其他类型	忽略

Tools​

类型	支持情况
function	支持
web_search / web_search_2025_08_26	支持，服务端执行。search_context_size、user_location 忽略
custom	仅支持 {"type": "custom", "name": "apply_patch"}（用于 Codex 兼容）；其他名称返回 400 错误
file_search / code_interpreter / computer_use / mcp 等其他内置工具	忽略

响应字段​

响应对象与 OpenAI Responses API 的 response 结构兼容。依赖未支持能力的字段恒为固定值（如 store: false、previous_response_id: null、parallel_tool_calls: true）。

Token 用量在 usage 中返回：

input_tokens：输入 token 数，其中 input_tokens_details.cached_tokens 为命中上下文缓存的 token 数

output_tokens：输出 token 数，其中 output_tokens_details.reasoning_tokens 为思维链 token 数








上一页

上下文硬盘缓存

下一页

使用 Anthropic API






将 DeepSeek 模型接入 Codex

通过 Responses API 调用 DeepSeek 模型

流式输出

兼容性明细
顶层请求参数

输入 Items

Tools

响应字段












微信公众号





社区

邮箱

Discord

Twitter



更多

GitHub




Copyright © 2026 DeepSeek, Inc.




------
导航页 打开网址