Doubao Seed 2.0 - 完全な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"

チャットメッセージリスト，マルチターン会話とマルチモーダル入力（テキスト、画像、動画）に対応

[
  {
    "role": "user",
    "content": [
      null
    ],
    "reasoning_content": "string",
    "tool_calls": [
      {
        "id": "string",
        "type": "function",
        "function": {
          "name": null,
          "arguments": null
        }
      }
    ],
    "tool_call_id": "string"
  }
]

控制模型是否ディープシンキングモードを有効化 モデルによってサポート状況やデフォルト値が異なります

{
  "type": "enabled"
}

レスポンスコンテンツをストリーミングで返すかどうか - `false`: モデルがすべてのコンテンツを生成した後に一括で結果を返す - `true`: SSEプロトコルに従いモデル生成コンテンツをチャンクごとに返し、`data: [DONE]`メッセージで終了します。streamがtrueの場合、stream_optionsフィールドを設定してトークン使用量統計情報を取得できます

false

ストリーミングレスポンスのオプション。streamがtrueの場合、このフィールドを設定できます

{
  "include_usage": true,
  "chunk_include_usage": false
}

モデル回答の最大長（単位: トークン） **注意**: - 模型回答不包含思考チェーンの内容（模型回答 = モデル出力 - モデル思考チェーン） - 出力トークンの総長はモデルのコンテキスト長制限も受けます - max_completion_tokensと同時に設定できません

4096

控制模型输出的最大长度，包括模型回答和思考チェーンの内容长度（单位 token） **说明**: - 値の範囲: [0, 65536] - 設定後max_tokensのデフォルト値は無効になり、モデルは必要に応じてコンテンツ（回答と思考チェーン）を出力し、この値に達するまで続けます - max_tokensと同時に設定できません - 建议在ディープシンキングモードを有効化时使用此参数

16384

サンプリング温度、出力のランダム性を制御 **说明**: - 値の範囲: [0, 2] - 低い値（例: 0.2）: より確定的で集中した出力 - 高い値（例: 0.8）: よりランダムで創造的な出力 - 値が0の場合、モデルは対数確率が最大の1つのトークンのみを考慮 - temperatureまたはtop_pのいずれか一方のみを調整することを推奨

0.7

核サンプリング確率閾値 **说明**: - 値の範囲: [0, 1] - モデルはtop_p内の確率質量を持つトークン結果を考慮します - 0.1 確率質量が最も高い上位10%のトークンのみを考慮することを意味します - 値が大きいほど生成のランダム性が高く、値が小さいほど生成の確定性が高い - temperatureまたはtop_pのいずれか一方のみを調整することを推奨

0.9

モデルはstopフィールドで指定された文字列に遭遇すると生成を停止し、その文字列自体は出力されません。最大4つの文字列をサポート **注意**: ディープシンキングモデルはこのフィールドをサポートしていません

[
  "こんにちは",
  "天気"
]

思考の作業量を制限し、思考深度を減らすと速度が向上し、思考に費やすトークンが少なくなります - `minimal`: 思考を無効化、直接回答 - `low`: 軽量思考、高速レスポンス重視 - `medium`: バランスモード、速度と深度を両立 - `high`: 深層分析、複雑な問題を処理

"medium"

モデルの回答形式を指定 3つの形式に対応: text（デフォルト）、json_object、json_schema

{
  "type": "text",
  "json_schema": {
    "name": "string",
    "description": "string",
    "schema": {},
    "strict": false
  }
}

頻度ペナルティ係数 **说明**: - 値の範囲: [-2.0, 2.0] - 正の値の場合、新しいトークンのテキスト中の出現頻度に基づいてペナルティを課し、モデルが逐語的に繰り返す可能性を低減します

0

存在ペナルティ係数 **说明**: - 値の範囲: [-2.0, 2.0] - 正の値の場合、新しいトークンがこれまでのテキストに出現したかどうかに基づいてペナルティを課し、モデルが新しいトピックについて話す可能性を高めます

0

出力トークンの対数確率を返すかどうか - `false`: 対数確率情報を返さない - `true`: 返回メッセージの内容中每个输出 token 的对数概率 **注意**: ディープシンキングモデルはこのフィールドをサポートしていません

false

各出力トークン位置で最も返される可能性の高いトークン数を指定、各トークンには関連する対数確率があります - 値の範囲: [0, 20] - logprobsがtrueの場合のみ設定可能 **注意**: ディープシンキングモデルはこのフィールドをサポートしていません

0

指定トークンがモデル出力に出現する確率を調整 **说明**: - mapを受け取り、キーは語彙のトークンID、値はバイアス値 - バイアス値の範囲: [-100, 100] - -1 は選択の可能性を減少させ、1は選択の可能性を増加させます - -100は完全にそのトークンの選択を禁止し、100はそのトークンのみ選択可能にします **注意**: ディープシンキングモデルはこのフィールドをサポートしていません

{}

呼び出すツールのリスト、モデルの返信にツール呼び出しリクエストを含めることができます

[
  {
    "type": "function",
    "function": {
      "name": "string",
      "description": "string",
      "parameters": {}
    }
  }
]

このリクエストで、モデルの返信に複数の呼び出すべきツールを含めることを許可するかどうか - `true`: 複数の呼び出すべきツールの返却を許可 - `false`: 返される呼び出し可能なツール数 <= 1

true

このリクエストで、モデルの返信に呼び出すべきツールがあるかどうか **文字列モード**: - `none`: モデルの返信に呼び出すべきツールを含めない - `required`: モデルの返信に呼び出すべきツールを必ず含める - `auto`: モデルが返信情報に呼び出すべきツールがあるかどうかを自動判断（ツールが存在する場合のデフォルト値） **オブジェクトモード**: 呼び出すツールの範囲を指定