豆包 Seed 系列

字節跳動的豆包 Seed 文字模型，包括 Seed 2.1 Pro、Seed 2.1 Turbo、Seed Evolving 與 Seed Character。透過 OpenAI 相容介面呼叫，除 Seed Character 外同時支援 Anthropic 原生介面，可在 Claude Code 中使用。豆包的圖片生成模型請見 Seedream（豆包），影片模型請見 Seedance。

常見任務

模型

完整的模型清單與即時價格請參閱模型頁 。模型 ID 的前綴為 volcengine/，可省略；寫成 bytedance/、doubao/ 前綴或火山方舟帶日期的模型名稱會回傳 404。

以上模型由火山引擎（volcengine）提供，皆支援 Chat Completions 與 Responses 介面。

呼叫範例

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="volcengine/doubao-seed-2.1-pro",
    messages=[{"role": "user", "content": "用一句話解釋什麼是冪等性。"}],
    extra_body={"thinking": {"type": "disabled"}},
)
print(resp.choices[0].message.content)

curl https://api.ofox.io/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volcengine/doubao-seed-2.1-pro",
    "messages": [{"role": "user", "content": "用一句話解釋什麼是冪等性。"}],
    "thinking": {"type": "disabled"}
  }'

深度思考

• thinking.type 支援 enabled 與 disabled，傳入 auto 會回傳 400。
• 實測「用一句話解釋什麼是冪等性」：Seed 2.1 Pro 預設思考約 1500 token、耗時約 40 秒；Seed Evolving 約 1700 token、約 54 秒。關閉思考後約 2 秒回傳。
• 思考 token 計入 max_tokens。上限設得過小時，content 可能為空，finish_reason 為 length。
• 思考 token 依輸出單價計費，數量請見 usage.completion_tokens_details.reasoning_tokens。

讀取思考內容：串流回應中位於 delta.reasoning_content；非串流回應中位於 message.reasoning_details，請將各項的 text 依序串接。

在 Claude Code 中使用

Seed 2.1 Pro、Seed 2.1 Turbo 與 Seed Evolving 支援 Anthropic 原生介面，位址為 https://api.ofox.io/anthropic：

• 透過 Anthropic 介面呼叫時，不傳入 thinking 參數就不會回傳思考內容。需要思考時傳入 "thinking": {"type": "enabled", "budget_tokens": 2000} 或 {"type": "adaptive"}，思考內容以 thinking 區塊回傳。
• Seed Character 不支援 Anthropic 介面，呼叫會回傳 protocol_not_supported。

Claude Code 的完整設定步驟請見 Claude Code 設定。

圖片輸入與結構化輸出

• 圖片輸入：以上模型皆支援圖片輸入，使用標準的 image_url 內容區塊，寫法請見視覺理解。圖片連結必須能從公開網路快速下載，否則會回傳 Timeout while downloading url；也可以改用 base64 資料。
• 結構化輸出：response_format 支援 json_schema 與 json_object，寫法請見結構化輸出。
• 工具呼叫：使用標準的 tools 參數，回傳 tool_calls。

常見錯誤

其他通用錯誤請見錯誤處理。

官方文件

• 火山方舟 · 文件 

常見問題