DeepSeek Responses

用一个 BeatAPI 密钥，通过 OpenAI Responses API 调用 DeepSeek V4.1 Flash、V4 Pro 及其高缓存版本。

• 一个端点 POST /v1/responses 覆盖当前所有 DeepSeek 模型，改 model 即可切换。
• 文本输入、文本输出，支持流式输出和函数调用，下表中的模型有 100 万 token 上下文。
• 兼容 OpenAI SDK：改 base URL，换成 BeatAPI 密钥即可。已有的 Chat Completions 集成见 Chat Completions。
• 服务端不保存会话状态：每一轮都要把完整历史放进 input。

在调试窗口里打开本接口，填入你的 BeatAPI API 密钥即可发送。调用是真实的，费用从你自己的余额中扣除。

模型

把下列 ID 之一作为 model 发送。它们是各自独立的模型，不是互相的别名。

• 价格为基础档，已计入折扣。长上下文档、缓存命中输入价和缓存写入价不在本表内，见价格表。
• — 表示目录未公布该数字。
• * 模型在高峰时段另有价格倍数；表中显示的是非高峰的基础价。

本系列仍可调用的旧 ID 见旧型号。

快速开始

在服务端安装 openai 包，把密钥放在 BEATAPI_API_KEY，不要把它写进浏览器代码。output_text 是 SDK 提供的取答案文本的快捷属性。以下是请求示例，不是真实的模型输出记录。

从 output_text（或 output 里 output_text 类型的片段）读取答案，再检查 status 和 usage。HTTP 200 不能证明答案满足你的任务，请在应用里校验内容。文本请求直接返回，不要为它们轮询 /v1/tasks。

curl --request POST \
  --url https://direct.beatapi.io/v1/responses \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "deepseek-v4.1-flash",
  "max_output_tokens": 2000,
  "input": "Design a resilient webhook retry strategy for a payments API."
}'

免费版本

这些模型有免费版本。免费版本不按 token 计费，用免费模型 ID 在同一个端点调用，并有单独的每分钟限额：首次充值前每个账号每分钟 1 次成功请求，充值后每分钟 10 次。它不保证稳定，随时可能被限流或下架。详见免费模型。

deepseek-v4.1-flash-free

curl --request POST \
  --url https://direct.beatapi.io/v1/responses \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "deepseek-v4.1-flash-free",
  "input": "Say hello in one sentence."
}'

deepseek-v4-flash-0731-free

curl --request POST \
  --url https://direct.beatapi.io/v1/responses \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "deepseek-v4-flash-0731-free",
  "input": "Say hello in one sentence."
}'

端点与鉴权

POST https://direct.beatapi.io/v1/responses

请求参数

接受标准的 OpenAI Responses 字段。请求格式兼容，不代表每个模型都支持所有选项或托管工具，请对你依赖的选项自行测试。

高缓存（HC）模型

deepseek-v4-pro-0813-hc 和 deepseek-v4.1-flash-hc 是同样两款模型，只是跑在高缓存线上。当请求共用同一段提示词前缀时，比如很长的系统提示词、工具列表或不断变长的对话，重复的前缀按缓存输入的费率计费。普通线每个 token 更便宜，但不保证命中缓存。

每次提示词里大部分内容都是反复发送的前缀时，选 HC 模型；重复很少的提示词，用普通模型更便宜。请求和普通模型完全一样，只需要换 model。是否命中缓存，请看 usage 里的缓存输入数量，不要想当然。

分时段费率

普通模型 deepseek-v4.1-flash 和 deepseek-v4-pro-0813 每天每个小时都按同一个费率计费。

两个 HC 模型有高峰时段。每个工作日北京时间（GMT+8）09:00–12:00 和 14:00–18:00，所有费率翻倍：输入、缓存输入和输出都一样。其余时间以及周六、周日全天，按非高峰费率计费，也就是上面模型表和价格表里显示的价格。

响应

非流式调用返回一个 JSON 对象。以下是精简后的示例。

{
  "id": "resp_example",
  "object": "response",
  "model": "deepseek-v4.1-flash",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Retry with exponential backoff and jitter, and make every handler idempotent."
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 19,
    "output_tokens": 16,
    "total_tokens": 35
  }
}

响应字段

流式输出

设置 "stream": true。流以 response.created 开始，答案通过 response.output_text.delta 事件逐段到达，最后以 response.completed 结束。

• 响应类型是 text/event-stream；不流式时是 application/json。
• 函数调用是单独的输出项，它的参数通过 response.function_call_arguments.delta 事件逐段到达。
• 调用模型之前就失败的请求，返回的是带 HTTP 状态码的普通 JSON 错误，而不是流事件。
• 请设置明确的超时，并安全地重连流式响应。

event: response.created
data: {"type":"response.created","response":{"id":"resp_example","status":"in_progress"}}
event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"Retry"}
event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":" with backoff"}
event: response.completed
data: {"type":"response.completed","response":{"id":"resp_example","status":"completed"}}

错误

HTTP 错误速查

认证、路由、限速和未知模型这几类失败发生在调用模型之前，返回 BeatAPI 信封：error.code、error.message、retryable、request_id。其余失败保持 OpenAI SDK 格式 {"error": {"message", "type", "code"}}：错误码在 error.code，request id 附在 message 末尾。详见错误码。

完整的错误码表和重试策略见错误码。

注意事项

• DeepSeek 模型也可以用 Chat Completions 和 Anthropic Messages 调用。
• 这些模型会先推理再作答。推理 token 计入输出 token，并按输出计费，所以 max_output_tokens 要同时为推理和答案留足空间。
• 只支持文本输入：这些模型不支持图片输入。
• 密钥只放在可信的服务端，记录响应里的请求 ID，只对 429、500 和 503 重试。