Doubao Seed 2.0 Responses API - Referencia completa de API

##所有接口均需要使用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"

输入内容。支持两种格式： **1. 纯文本字符串**: 等同于 user 角色输入的文本信息 **2. 元素列表 (array)**: 包含消息、上下文、工具调用等多种输入类型

在模型上下文中插入系统消息或开发者指令作为第一条指令 **注意**: - 与 previous_response_id 一起使用时，前一个回复中的指令不会被继承 - 不可与 caching 缓存能力一起使用

"string"

上一个模型回复的唯一标识符，用于实现多轮对话 **说明**: - 传入后会引入上一轮请求的输入和回答内容，本次请求的输入 tokens 会相应增加 - 在多轮连续对话中，建议在每次请求之间加入约 100 毫秒的延迟

"string"

存储的过期时刻，UTC Unix 时间戳（秒） **说明**: - 取值范围: (创建时刻, 创建时刻 + 604800]，即最多保留 7 天 - 默认值: 创建时刻 + 259200（3天） - 对 store 和 caching 都生效 - 缓存存储时间计费，不满 1 小时按 1 小时计算

0

模型输出最大 token 数，包含模型回答和思维链内容

32768

控制模型是否Activar modo de pensamiento profundo

{
  "type": "enabled"
}

限制深度思考的工作量，减少可使响应速度更快、token 用量更少

{
  "effort": "medium"
}

是否开启上下文缓存 **注意**: 不可与 instructions 字段、tools（除 Function Calling 外）字段一起使用

{
  "type": "disabled",
  "prefix": false
}

是否储存生成的模型响应，以便后续通过 API 检索 - `true`: 储存当前模型响应 - `false`: 不储存

true

响应内容是否流式返回 - `false`: 模型生成完所有内容后一次性返回 - `true`: 按 SSE 协议逐块返回，以 `data: [DONE]` 消息结束

false

采样温度，控制输出随机性 - 取值范围: [0, 2] - 较低值更确定，较高值更随机 - 建议仅调整 temperature 或 top_p 其中之一 **注意**: doubao-seed-2.0-pro 和 doubao-seed-2.0-lite 固定为 1，手动指定会被忽略

1

核采样概率阈值 - 取值范围: [0, 1] - 建议仅调整 temperature 或 top_p 其中之一 **注意**: doubao-seed-2.0-pro 和 doubao-seed-2.0-lite 固定为 0.95，手动指定会被忽略

0.7

模型文本输出的格式定义

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

模型可以调用的工具列表 支持以下工具类型： - `function`: 自定义函数（Function Calling） - `web_search`: Búsqueda web - `doubao_app`: 豆包助手 - `image_process`: 图像处理 - `mcp`: MCP 工具 - `knowledge_search`: 私域知识库搜索

[
  {
    "type": "function",
    "name": "string",
    "description": "string",
    "parameters": {},
    "strict": true,
    "feature": {
      "chat": {
        "type": "disabled",
        "role_description": "string"
      },
      "deep_chat": {
        "type": "disabled",
        "role_description": "string"
      },
      "ai_search": {
        "type": "disabled",
        "role_description": "string"
      },
      "reasoning_search": {
        "type": "disabled",
        "role_description": "string"
      }
    },
    "user_location": {
      "type": "approximate",
      "country": "string",
      "region": "string",
      "city": "string"
    },
    "sources": [
      "toutiao"
    ],
    "limit": 0,
    "max_keyword": 0,
    "point": {
      "type": "enabled"
    },
    "grounding": {
      "type": "enabled"
    },
    "zoom": {
      "type": "enabled"
    },
    "rotate": {
      "type": "enabled"
    },
    "server_label": "string",
    "server_url": "string",
    "headers": {},
    "require_approval": null,
    "allowed_tools": null,
    "knowledge_resource_id": "string",
    "doc_filters": {},
    "dense_weight": 0.5,
    "ranking_options": {
      "rerank_switch": false,
      "retrieve_count": 25,
      "get_attachment_link": false,
      "chunk_diffusion_count": 0,
      "chunk_group": false,
      "rerank_model": "base-multilingual-rerank",
      "rerank_only_chunk": false
    }
  }
]

控制模型是否调用工具 **字符串模式**: - `none`: 不调用工具 - `required`: 必须调用工具 - `auto`: 模型自行判断（默认） **对象模式**: 指定调用特定工具

最大工具调用轮次（一轮不限次数） - 取值范围: [1, 10] - Web Search 默认值 3 - Image Process 默认值 10（不支持修改） - Knowledge Search 默认值 3 **注意**: 该参数为尽力而为机制，最终调用次数受模型推理效果等因素影响

0

上下文管理策略，帮助模型有效利用上下文窗口

{
  "edits": [
    {
      "type": "clear_thinking",
      "keep": null,
      "exclude_tools": [
        "string"
      ],
      "clear_tool_input": false,
      "trigger": {
        "type": "tool_uses",
        "value": 0
      }
    }
  ]
}