Doubao Seed 2.0 Responses API - 完全なAPIリファレンス

##すべてのAPIにBearer Token認証が必要です## **APIキーの取得：** [APIキー管理ページ](https://starmagic.ai/app/api-keys)にアクセスしてAPIキーを取得してください **リクエストヘッダーに追加：** ``` 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"

输入コンテンツ。2つの形式に対応： **1. テキスト文字列**: userロールが入力したテキスト情報と同等 **2. 要素リスト (array)**: メッセージ、コンテキスト、ツール呼び出しなど複数の入力タイプを含む

在模型上下文中插入システムメッセージ或开发者指令作为第一条指令 **注意**: - previous_response_idと併用する場合、前の返信の指示は継承されません - cachingキャッシュ機能と併用できません

"string"

前のモデル返信の一意識別子、マルチターン会話の実現に使用 **说明**: - 渡すと前回のリクエストの入力と回答内容が導入され、今回のリクエストの入力トークンが相応に増加します - マルチターン連続会話では、各リクエスト間に約100ミリ秒の遅延を入れることを推奨

"string"

ストレージの有効期限、UTC Unixタイムスタンプ（秒） **说明**: - 値の範囲: (作成時刻, 作成時刻 + 604800]、最大7日間保持 - デフォルト値: 作成時刻 + 259200（3日間） - storeとcachingの両方に有効 - キャッシュストレージ時間で課金、1時間未満は1時間として計算

0

モデル出力の最大トークン数，包含模型回答和思考チェーンの内容

32768

控制模型是否ディープシンキングモードを有効化

{
  "type": "enabled"
}

ディープシンキングの作業量を制限し、削減するとレスポンス速度が速くなり、トークン使用量が少なくなります

{
  "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`: ウェブ検索 - `doubao_app`: Doubaoアシスタント - `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ラウンドの回数制限なし） - 値の範囲: [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
      }
    }
  ]
}