豆包（火山）— OpenAI 格式

POST/v1/chat/completions

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

Bearer Token

模型介绍

豆包是火山引擎推出的大模型系列，擅长中文理解、内容创作与代码生成。除 OpenAI 兼容协议外，豆包还支持全新的 Responses API。

支持模型

豆包模型列表

模型	上下文长度	最大输出	思考模式	工具调用	缓存	多模态
doubao-seed-2.0-pro	256,000	32,768	✅	✅	✅	文本+图像
doubao-seed-2.0-lite	128,000	16,384	❌	✅	✅	仅文本
doubao-seed-2.0-code	256,000	32,768	✅	✅	✅	代码专精

请求参数

请求参数

参数	类型	必填	默认值	描述
model	string	是	-	模型名称：doubao-seed-2.0-pro / doubao-seed-2.0-lite / doubao-seed-2.0-code
messages	array	是	-	消息列表，结构同 OpenAI 标准
stream	boolean	否	false	是否流式返回（SSE）
max_tokens	integer	否	4,096	最大输出 token 数；与 max_completion_tokens 互斥
max_completion_tokens	integer	否	-	最大输出 token 数，取值 1–65536；与 max_tokens 互斥
temperature	number	否	1.0	采样温度
top_p	number	否	0.7	核采样概率（注意：方舟默认值不是 OpenAI 的 1.0）
reasoning_effort	string	否	-	思考模式强度，统一 7 值：none / minimal / low / medium / high / xhigh / max（无 ultra）
thinking	object	否	-	思考模式开关：{"type":"enabled"} / {"type":"disabled"} / {"type":"auto"}
prompt_cache_key	string	否	-	上下文缓存路由标识
tools	array	否	-	工具定义列表
tool_choice	string	否	auto	工具调用策略
stream_options	object	否	-	{"chunk_include_usage": true}：每个 chunk 是否带累计 usage

请求示例

curl -X POST /v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-2.0-pro",
    "messages": [
      {"role": "user", "content": "帮我写一封项目启动会的会议邀请邮件。"}
    ]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="/v1",
    api_key="YOUR_API_KEY",
)

resp = client.chat.completions.create(
    model="doubao-seed-2.0-pro",
    messages=[
        {"role": "user", "content": "帮我写一封项目启动会的会议邀请邮件。"},
    ],
)
print(resp.choices[0].message.content)

响应示例

成功响应

{
  "id": "0217356613000003bb05cf5cd819fbca5f0b8d67a025022a1b2c3",
  "object": "chat.completion",
  "created": 1735661300,
  "model": "doubao-seed-2.0-pro",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "主题：会议邀请——项目启动会\n\n尊敬的各位：……"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 200,
    "total_tokens": 210
  }
}

注意事项

• 响应 id 由平台按原厂形态归一：02 + 13 位毫秒时间戳 + 32 位 hex + 6 位 hex（共 53 字符）。
• doubao-seed-2.0-lite 不支持思考模式与多模态输入。
• 豆包的思考过程以 <think>…</think> 标签包裹，计为输出 token。
• 本平台 OpenAI 兼容入口没有 cache 请求参数（传入会被忽略）；需要固定缓存路由时请用 prompt_cache_key。上下文缓存命中计价以方舟官方规则与本站价格页为准。
• ⚠️ 本页能力表的上下文长度 / 最大输出（doubao-seed-2.0-pro 256,000 / 32,768 等）未在官方基线中登记（未取证），且与 Responses API 页（128,000 / 8,000 等）互相矛盾——两者必有一处不准，请以控制台与方舟官方文档为准。
• 如需更简洁的调用方式，可使用 Responses API。