DeepSeek - 完整参数文档

##所有接口均需要使用Bearer Token进行认证## **获取 API Key：** 访问 [API Key 管理页面](https://starmagic.ai/app/api-keys) 获取您的 API Key **使用时在请求头中添加：** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

对话模型名称 - `deepseek-chat`：通用对话模型 - `deepseek-reasoner`：深度推理模型，擅长数学、编程和复杂逻辑推理 **注意**：`deepseek-reasoner` 不支持 `temperature`、`top_p`、`tools`、`tool_choice`、`response_format` 参数，传入会被上游拒绝

"deepseek-chat"

对话消息列表，支持多轮对话 不同角色的消息具有不同的字段结构，请选择对应角色查看

[
  null
]

思考模式控制（Beta） **说明**: - 用于控制 `deepseek-reasoner` 模型的深度思考功能 - 启用后模型会在回复前进行深度推理

{
  "type": "enabled"
}

频率惩罚参数，用于减少重复内容 **说明**: - 正值会根据 token 在已生成文本中出现的频率进行惩罚 - 值越大，越不容易重复已出现的内容 - 默认值: 0（不惩罚）

0

限制生成内容的最大 token 数量 **说明**: - 设置后模型会在达到该数量时停止生成 - 不设置则由模型自行决定生成长度

4096

存在惩罚参数，用于鼓励生成新话题 **说明**: - 正值会根据 token 是否已在文本中出现过进行惩罚 - 值越大，越倾向于讨论新话题 - 默认值: 0（不惩罚）

0

指定响应格式 **说明**: - 设置为 `{"type": "json_object"}` 可启用 JSON 模式 - JSON 模式下模型会输出合法的 JSON 格式内容

{
  "type": "text"
}

停止序列，模型遇到这些字符串时会停止生成 **说明**: - 可以是单个字符串或字符串数组 - 最多支持 16 个停止序列

是否以流式方式返回响应 - `true`: 流式返回，通过 SSE（Server-Sent Events）逐块实时返回内容 - `false`: 等待完整响应后一次性返回

false

流式响应选项 仅在 `stream=true` 时有效

{
  "include_usage": true
}

采样温度，控制输出的随机性 **说明**: - 较低值(如 0.2): 更确定、更聚焦的输出 - 较高值(如 1.5): 更随机、更有创意的输出 - 默认值: 1

1

核采样(Nucleus Sampling)参数 **说明**: - 控制从累积概率前多少的token中采样 - 例如 0.9 表示从累积概率达到90%的token中选择 - 默认值: 1.0（考虑所有token） **建议**: 不要同时调整 temperature 和 top_p

1

工具定义列表，用于 Function Calling **说明**: - 最多支持 128 个工具定义 - 每个工具需要定义名称、描述和参数 schema

[
  {
    "type": "function",
    "function": {
      "name": "string",
      "description": "string",
      "parameters": {},
      "strict": false
    }
  }
]

控制工具调用行为 **可选值**: - `none`：不调用任何工具 - `auto`：模型自动决定是否调用工具 - `required`：强制模型调用一个或多个工具 **默认值**：未提供 tools 时为 `none`，提供 tools 时为 `auto`

是否返回 token 的对数概率 **说明**: - 设置为 `true` 时，响应中会包含每个 token 的对数概率信息

false

返回概率最高的前 N 个 token 的对数概率 **说明**: - 需要 `logprobs` 设置为 `true` - 取值范围: `[0, 20]`

0