doubao-seed-2-1-pro-260915

调用示例

正式 Base URL 为 https://www.unicompapi.com/v1；设置 UNICOMP_BASE_URL 与 UNICOMP_API_KEY 后替换素材与 Base64 占位内容。新请求使用 REQUEST_KEY，响应 X-Unicomp-Request-Id 保存为 REQUEST_ID；两者用于查询同一原单。

POST /v1/chat/completions

# 仅用于新请求；未知结果时查询原单，不重新执行本段
# 需要 Python 3；保存打印的 REQUEST_KEY
REQUEST_KEY="$(python3 -c 'import uuid; print(uuid.uuid4())')"
[ -n "$REQUEST_KEY" ] || exit 1 # UUID生成失败时停止
printf 'REQUEST_KEY=%s\n' "$REQUEST_KEY"
curl "$UNICOMP_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $UNICOMP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $REQUEST_KEY" \
  --data '{
  "model": "doubao-seed-2-1-pro-260915",
  "messages": [
    {
      "role": "user",
      "content": "你好，请用一句话介绍自己。"
    }
  ],
  "max_completion_tokens": 4096
}'

字段与限制

• Seed21：max_tokens为回答预算（1–262144），max_completion_tokens为完成总预算（1–524288，含思考），二选一并保留原请求值；思考最多262144 Token，未指定时采用max_completion_tokens=4096。声明上限不等于当前渠道边界已实测。
• 支持stream:true时返回SSE，须收到完整finish及[DONE]；usage是否输出按stream_options.include_usage设置，省略时遵循本型号默认。客户端不输出usage不影响平台按内部完整用量结算。中断或未知结果应核查原请求，不能自动重新POST。
• 当前上下文 1048576 Token；输入与输出须符合本型号Token容量；请求大小限制见容量说明。响应最多32MiB，最长等待30分钟。连接中断时查询原请求，不重复提交。
• 本型号默认回复预算 4096 Token；这是平台默认值，不是模型的最大输出能力。
• Chat原生reasoning_effort：none、minimal、low、medium、high、xhigh、max；按原值发送，none/minimal与xhigh/max的行为映射不改写请求。service_tier：auto、default，省略跟随模型默认。
• 原assistant.encrypted_content为不透明字符串；存在时完整原样回传，包括空串，同时保留原content的null或空字符串、reasoning_content及tool_calls。不得解密、拼接为正文、放入提示词或日志；工具结果用匹配tool_call_id显式续轮，每轮独立计费。

流式文字

选择已开放的纯文字组合，再添加stream:true，图片输入不使用此示例；SDK关闭自动重试，逐个消费SSE。以下为格式示意，不是实际调用结果。

{
  "model": "doubao-seed-2-1-pro-260915",
  "messages": [
    {
      "role": "user",
      "content": "你好，请用一句话介绍自己。"
    }
  ],
  "max_completion_tokens": 4096,
  "stream": true
}

data: {"choices":[{"index":0,"delta":{"content":"你好"},"finish_reason":null}]}

data: {"choices":[{"index":0,"delta":{},"finish_reason":"stop"}],"usage":{"prompt_tokens":8,"completion_tokens":2,"total_tokens":10}}

data: [DONE]

请求组合示例

示例随当前型号配置生成；请替换素材与历史消息占位内容。选择相应组合展开查看，不要混用不同组合参数。

{
  "model": "doubao-seed-2-1-pro-260915",
  "max_completion_tokens": 512,
  "stream": false,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "比较图片内容"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/replace-with-your-image.png",
            "detail": "xhigh"
          }
        }
      ]
    }
  ]
}

{
  "model": "doubao-seed-2-1-pro-260915",
  "max_completion_tokens": 512,
  "stream": false,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "描述视频内容"
        },
        {
          "type": "video_url",
          "video_url": {
            "url": "https://example.com/replace-with-your-video.mp4",
            "fps": 0.2
          }
        }
      ]
    }
  ]
}

{
  "model": "doubao-seed-2-1-pro-260915",
  "max_completion_tokens": 512,
  "stream": false,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "描述文件中的图片"
        },
        {
          "type": "image_url",
          "image_url": {
            "file_id": "<同Key上传返回的文件ID>",
            "detail": "high"
          }
        }
      ]
    }
  ]
}

当前价格

接口金额使用整数微元：1元 = 1,000,000微元。按报价和实际用量结算。

响应与结果

非流式响应choices[].message.content和usage；文字stream:true返回text/event-stream delta、finish与[DONE]。OCR只支持非流式。

保存Idempotency-Key和X-Unicomp-Request-Id。使用请求号查询状态与费用，客户端禁自动重试未知请求；401核Key，400核字段，402核余额，409核幂等或报价变化，503检查型号或服务状态。