DeepSeek — OpenAI 格式

POST/v1/chat/completions

调用 DeepSeek 系列模型进行文本对话，兼容 OpenAI Chat Completions 协议。

Bearer Token

模型介绍

DeepSeek 专注于推理与通用能力的均衡发展。deepseek-v4-pro 适合复杂推理与长文本分析，deepseek-v4-flash 则在保持优秀生成质量的同时大幅降低延迟和费用。

支持模型

DeepSeek 模型列表

模型	上下文长度	最大输出	思考模式	工具调用	缓存	多模态
`deepseek-v4-pro`	1,000,000	393,216	✅	✅	✅	仅文本
`deepseek-v4-flash`	1,000,000	393,216	✅	✅	✅	仅文本

思考模式提示：开启思考（reasoning）后，思考内容计入 max_tokens——设置过小（如 <100）时思考可能占满配额，content 返回空串且 finish_reason=length。建议思考模式调用时 max_tokens ≥ 1024。

请求参数

参数	类型	必填	默认值	描述
model	string	是	-	模型名称：`deepseek-v4-pro` / `deepseek-v4-flash`
messages	array	是	-	消息列表，结构同 OpenAI 标准
stream	boolean	否	false	是否流式返回（SSE）
max_tokens	integer	否	非思考 8K / 思考 64K / `effort=max` 时 128K	最大输出 token 数，取值 `1`–`393216`（384K）；与输入合计受上下文 1M 限制
temperature	number	否	1.0	采样温度，0~2（思考模式下不生效，不报错）
top_p	number	否	1.0	核采样概率，仅思考模式生效（有效区间 0.95~1.0）；非思考模式固定 1.0 并忽略传入值
reasoning_effort	string	否	`high`	思考模式强度：`none` / `low` / `high` / `max`；兼容别名 `minimal`→`low`、`medium`/`xhigh`→`high`、`ultra`→`max`。`deepseek-v4-pro` 与 `deepseek-v4-flash` 均支持
thinking	object	否	`{"type":"enabled"}`	思考模式开关：`{"type":"enabled"}` / `{"type":"disabled"}`
tools	array	否	-	工具定义列表，结构同 OpenAI
tool_choice	string	否	无 tools 时 `none`；有 tools 时 `auto`	工具调用策略：`none` / `auto` / `required` / 具名（思考模式下 `required` 与具名不支持，会返回 400）
stream_options	object	否	-	`{"include_usage": true}`；必须与 `stream: true` 同用，否则返回 400
user_id	string	否	-	DeepSeek 官方字段名（不是 OpenAI 的 `user`）：字符集 `[a-zA-Z0-9\-_]+`，最长 512；用于内容安全隔离 / KVCache 隔离 / 调度隔离
stop	string 或 array	否	-	停止词，最多 16 条

请求示例

bash

curl -X POST /v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [
      {"role": "user", "content": "用 Python 实现快速排序。"}
    ]
  }'

响应示例

成功响应

json

{
  "id": "8f14e45f-ceea-467a-9b3a-1d2c3b4a5e6f",
  "object": "chat.completion",
  "created": 1735660900,
  "model": "deepseek-v4-pro",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "[python code: def quick_sort(arr): ...]"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 110,
    "total_tokens": 122
  }
}

注意事项

响应 id 由平台按原厂形态归一：非流式 chat 与 Responses 为 UUID，流式 chat chunk 为 32 位 hex（不要对长度或分隔符做硬编码解析）。
deepseek-v4-flash 同样支持思考模式（官方「模型细节」表：两个模型都是「支持非思考与思考模式（默认）」）。
本文档不再列出 cache 请求参数：本平台 OpenAI 兼容入口不解析该字段，传入会被忽略；上下文缓存命中计价以 DeepSeek 官方规则与本站价格页为准。
DeepSeek 的工具调用返回结构与 OpenAI 完全一致，可直接复用现有 SDK。
请求体格式或上下文长度超出限制时会返回 400（DeepSeek 官方仅定义 HTTP 状态码，未定义响应体内的错误码字符串）。
frequency_penalty / presence_penalty 官方已标记 deprecated，传入不生效。
官方字段名是 user_id（不是 OpenAI 的 user），传 user 不会被识别。
思考过程以 <think>…</think> 标签包裹，计为输出 token。

DeepSeek — OpenAI 格式 ​

模型介绍 ​

支持模型 ​

请求参数 ​

请求示例 ​

响应示例 ​