豆包 Seed シリーズ

ByteDance の豆包（Doubao）Seed テキストモデルで、Seed 2.1 Pro、Seed 2.1 Turbo、Seed Evolving、Seed Character があります。OpenAI 互換 API で呼び出し、Seed Character を除いて Anthropic ネイティブ API にも対応しているため、Claude Code で使えます。豆包の画像生成モデルは Seedream（豆包）、動画モデルは Seedance を参照してください。

目的別ガイド

モデル

モデルの全一覧とリアルタイム価格はモデルページ を参照してください。モデル ID のプレフィックスは volcengine/ で、省略できます。bytedance/ や doubao/ のプレフィックス、または Volcano Engine Ark（火山方舟）の日付付きモデル名で書くと 404 を返します。

上記のモデルは Volcano Engine（volcengine）から提供されており、いずれも Chat Completions と Responses API に対応しています。

呼び出し例

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/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.ai/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 トークン思考して約 40 秒、Seed Evolving は約 1700 トークンで約 54 秒かかりました。思考を無効にすると約 2 秒で応答しました。
• 思考トークンは max_tokens に含まれます。上限が小さすぎると content が空になり、finish_reason が length になることがあります。
• 思考トークンは出力単価で課金され、トークン数は 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 ネイティブ API に対応しています。URL は https://api.ofox.ai/anthropic です。

• Anthropic API で呼び出す場合、thinking パラメーターを渡さなければ思考内容は返されません。思考が必要な場合は "thinking": {"type": "enabled", "budget_tokens": 2000} または {"type": "adaptive"} を渡すと、思考内容が thinking ブロックとして返されます。
• Seed Character は Anthropic API に対応しておらず、呼び出すと protocol_not_supported を返します。

Claude Code の設定手順の詳細は Claude Code の設定を参照してください。

画像入力と構造化出力

• 画像入力：上記のモデルはすべて画像入力に対応しており、標準の image_url コンテンツブロックを使います。書き方は画像理解を参照してください。画像の URL はインターネットからすばやくダウンロードできる必要があり、そうでない場合は Timeout while downloading url を返します。base64 データを使うこともできます。
• 構造化出力：response_format は json_schema と json_object に対応しています。書き方は構造化出力を参照してください。
• ツール呼び出し：標準の tools パラメーターを使い、tool_calls を返します。

よくあるエラー

その他の共通エラーは Error Handling を参照してください。

公式ドキュメント

• Volcano Engine Ark（火山方舟）· ドキュメント 

よくある質問