Doubao Seed 2.0 - 完整参数文档

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

Authorization: Bearer YOUR_API_KEY

对话模型名称 - `doubao-seed-2.0-pro`: 旗舰版，综合能力最强，适合复杂推理和高质量生成 - `doubao-seed-2.0-lite`: 轻量版，速度更快，性价比高 - `doubao-seed-2.0-mini`: 极速版，响应最快，适合简单任务 - `doubao-seed-2.0-code`: 代码专用版，针对代码生成和理解优化

"doubao-seed-2.0-pro"

对话消息列表，支持多轮对话和多模态输入（文本、图片、视频）

[
  {
    "role": "user",
    "content": [
      null
    ],
    "reasoning_content": "string",
    "tool_calls": [
      {
        "id": "string",
        "type": "function",
        "function": {
          "name": null,
          "arguments": null
        }
      }
    ],
    "tool_call_id": "string"
  }
]

控制模型是否开启深度思考模式 不同模型是否支持以及默认取值不同

{
  "type": "enabled"
}

响应内容是否流式返回 - `false`: 模型生成完所有内容后一次性返回结果 - `true`: 按 SSE 协议逐块返回模型生成内容，并以一条 `data: [DONE]` 消息结束。当 stream 为 true 时，可设置 stream_options 字段以获取 token 用量统计信息

false

流式响应的选项。当 stream 为 true 时，可设置此字段

{
  "include_usage": true,
  "chunk_include_usage": false
}

模型回答最大长度（单位 token） **注意**: - 模型回答不包含思维链内容（模型回答 = 模型输出 - 模型思维链） - 输出 token 的总长度还受模型的上下文长度限制 - 不可与 max_completion_tokens 同时设置

4096

控制模型输出的最大长度，包括模型回答和思维链内容长度（单位 token） **说明**: - 取值范围: [0, 65536] - 配置后 max_tokens 默认值失效，模型按需输出内容（回答和思维链），直到达到此值 - 不可与 max_tokens 同时设置 - 建议在开启深度思考模式时使用此参数

16384

采样温度，控制输出的随机性 **说明**: - 取值范围: [0, 2] - 较低值 (如 0.2): 更确定、更聚焦的输出 - 较高值 (如 0.8): 更随机、更有创意的输出 - 取值为 0 时模型仅考虑对数概率最大的一个 token - 建议仅调整 temperature 或 top_p 其中之一

0.7

核采样概率阈值 **说明**: - 取值范围: [0, 1] - 模型会考虑概率质量在 top_p 内的 token 结果 - 0.1 意味着只考虑概率质量最高的前 10% 的 token - 取值越大生成的随机性越高，取值越低生成的确定性越高 - 建议仅调整 temperature 或 top_p 其中之一

0.9

模型遇到 stop 字段所指定的字符串时将停止继续生成，这个词语本身不会输出。最多支持 4 个字符串 **注意**: 深度思考模型不支持该字段

[
  "你好",
  "天气"
]

限制思考的工作量，减少思考深度可提升速度，思考花费的 token 更少 - `minimal`: 关闭思考，直接回答 - `low`: 轻量思考，侧重快速响应 - `medium`: 均衡模式，兼顾速度与深度 - `high`: 深度分析，处理复杂问题

"medium"

指定模型回答格式 支持三种格式: text（默认）、json_object、json_schema

{
  "type": "text",
  "json_schema": {
    "name": "string",
    "description": "string",
    "schema": {},
    "strict": false
  }
}

频率惩罚系数 **说明**: - 取值范围: [-2.0, 2.0] - 值为正时，根据新 token 在文本中的出现频率对其进行惩罚，降低模型逐字重复的可能性

0

存在惩罚系数 **说明**: - 取值范围: [-2.0, 2.0] - 值为正时，根据新 token 到目前为止是否出现在文本中对其进行惩罚，增加模型谈论新主题的可能性

0

是否返回输出 tokens 的对数概率 - `false`: 不返回对数概率信息 - `true`: 返回消息内容中每个输出 token 的对数概率 **注意**: 深度思考模型不支持该字段

false

指定每个输出 token 位置最有可能返回的 token 数量，每个 token 都有关联的对数概率 - 取值范围: [0, 20] - 仅当 logprobs 为 true 时可设置 **注意**: 深度思考模型不支持该字段

0

调整指定 token 在模型输出内容中出现的概率 **说明**: - 接受一个 map，键为词表中的 token ID，值为偏差值 - 偏差值取值范围: [-100, 100] - -1 会减少选择的可能性，1 会增加选择的可能性 - -100 会完全禁止选择该 token，100 会导致仅可选择该 token **注意**: 深度思考模型不支持该字段

{}

待调用工具的列表，模型返回信息中可包含工具调用请求

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

本次请求，模型返回是否允许包含多个待调用的工具 - `true`: 允许返回多个待调用的工具 - `false`: 允许返回的待调用工具数量 <= 1

true

本次请求，模型返回信息中是否有待调用的工具 **字符串模式**: - `none`: 模型返回信息中不包含待调用的工具 - `required`: 模型返回信息中必须包含待调用的工具 - `auto`: 模型自行判断返回信息是否有待调用的工具（存在工具时的默认值） **对象模式**: 指定待调用工具的范围