メインコンテンツへスキップ
POST
/
v1
/
responses
curl --request POST \
  --url https://direct.evolink.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seed-2.0-pro",
  "input": "自己紹介をしてください"
}
'
{
  "id": "resp_02177148667427813c33c36521378d02b2c8389204fa8c3e2f63e",
  "object": "response",
  "created_at": 1771486674,
  "model": "doubao-seed-2-0-code-preview-260215",
  "status": "completed",
  "output": [
    {
      "id": "rs_0217****404a",
      "type": "reasoning",
      "summary": [
        {
          "text": "<string>",
          "type": "summary_text"
        }
      ],
      "status": "completed"
    }
  ],
  "service_tier": "default",
  "instructions": "<string>",
  "previous_response_id": "<string>",
  "max_output_tokens": 32768,
  "temperature": 123,
  "top_p": 123,
  "thinking": {},
  "tools": "<array>",
  "tool_choice": "<unknown>",
  "parallel_tool_calls": true,
  "text": {},
  "usage": {
    "input_tokens": 88,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 230,
    "output_tokens_details": {
      "reasoning_tokens": 211
    },
    "total_tokens": 318
  },
  "caching": {},
  "store": true,
  "expire_at": 1756539922,
  "error": {},
  "incomplete_details": {}
}
BaseURL：デフォルトの BaseURL は https://direct.evolink.ai で、テキストモデルへの対応が優れており、長時間接続をサポートします。https://api.evolink.ai はマルチモーダルの主力エンドポイントで、テキストモデルに対しては代替アドレスとして使用されます。

承認

​
Authorization
string
header
必須

##すべてのAPIにBearer Token認証が必要です##

APIキーの取得：

APIキー管理ページにアクセスしてAPIキーを取得してください

リクエストヘッダーに追加：

Authorization: Bearer YOUR_API_KEY

ボディ

application/json
​
model
enum<string>
デフォルト:doubao-seed-2.0-pro
必須

チャットモデル名

  • 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,
doubao-seed-2.0-lite,
doubao-seed-2.0-mini,
doubao-seed-2.0-code
例:

"doubao-seed-2.0-pro"

​
input
必須

输入コンテンツ。2つの形式に対応：

1. テキスト文字列: userロールが入力したテキスト情報と同等

2. 要素リスト (array): メッセージ、コンテキスト、ツール呼び出しなど複数の入力タイプを含む

​
instructions
string | null

在模型上下文中插入システムメッセージ或开发者指令作为第一条指令

注意:

  • previous_response_idと併用する場合、前の返信の指示は継承されません
  • cachingキャッシュ機能と併用できません
​
previous_response_id
string | null

前のモデル返信の一意識別子、マルチターン会話の実現に使用

说明:

  • 渡すと前回のリクエストの入力と回答内容が導入され、今回のリクエストの入力トークンが相応に増加します
  • マルチターン連続会話では、各リクエスト間に約100ミリ秒の遅延を入れることを推奨
​
expire_at
integer

ストレージの有効期限、UTC Unixタイムスタンプ（秒）

说明:

  • 値の範囲: (作成時刻, 作成時刻 + 604800]、最大7日間保持
  • デフォルト値: 作成時刻 + 259200（3日間）
  • storeとcachingの両方に有効
  • キャッシュストレージ時間で課金、1時間未満は1時間として計算
​
max_output_tokens
integer | null

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

例:

32768

​
thinking
object

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

​
reasoning
object

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

​
caching
object

コンテキストキャッシュを有効にするかどうか

注意: instructionsフィールド、tools（Function Calling以外）フィールドと併用できません

​
store
boolean | null
デフォルト:true

生成されたモデルレスポンスを保存し、後でAPI経由で取得できるようにするかどうか

  • true: 現在のモデルレスポンスを保存
  • false: 保存しない
​
stream
boolean | null
デフォルト:false

レスポンスコンテンツをストリーミングで返すかどうか

  • false: モデルがすべてのコンテンツを生成した後に一括返却
  • true: SSEプロトコルに従いチャンクごとに返し、data: [DONE]メッセージで終了
​
temperature
number | null
デフォルト:1

サンプリング温度、出力のランダム性を制御

  • 値の範囲: [0, 2]
  • 低い値はより確定的、高い値はよりランダム
  • temperatureまたはtop_pのいずれか一方のみを調整することを推奨

注意: doubao-seed-2.0-proとdoubao-seed-2.0-liteは1に固定されており、手動指定は無視されます

必須範囲: 0 <= x <= 2
​
top_p
number | null
デフォルト:0.7

核サンプリング確率閾値

  • 値の範囲: [0, 1]
  • temperatureまたはtop_pのいずれか一方のみを調整することを推奨

注意: doubao-seed-2.0-proとdoubao-seed-2.0-liteは0.95に固定されており、手動指定は無視されます

必須範囲: 0 <= x <= 1
​
text
object

モデルテキスト出力の形式定義

​
tools
object[]

模型可以调用的ツールリスト

支持以下ツールタイプ：

  • function: カスタム関数（Function Calling）
  • web_search: ウェブ検索
  • doubao_app: Doubaoアシスタント
  • image_process: 画像処理
  • mcp: MCP 工具
  • knowledge_search: プライベートナレッジベース検索
​
tool_choice

モデルがツールを呼び出すかどうかを制御

文字列モード:

  • none: ツールを呼び出さない
  • required: ツールの呼び出しが必須
  • auto: モデルが自動判断（デフォルト）

オブジェクトモード: 特定のツールの呼び出しを指定

利用可能なオプション:
none,
auto,
required
​
max_tool_calls
integer

最大ツール呼び出しラウンド数（1ラウンドの回数制限なし）

  • 値の範囲: [1, 10]
  • Web Search デフォルト値3
  • Image Process デフォルト値10（変更不可）
  • Knowledge Search デフォルト値3

注意: このパラメータはベストエフォート方式であり、最終的な呼び出し回数はモデルの推論効果などの要因に影響されます

必須範囲: 1 <= x <= 10
​
context_management
object

コンテキスト管理戦略、モデルがコンテキストウィンドウを効果的に活用するのを支援

レスポンス

レスポンス生成成功

​
id
string

このレスポンスの一意識別子

例:

"resp_02177148667427813c33c36521378d02b2c8389204fa8c3e2f63e"

​
object
enum<string>

オブジェクトタイプ、responseに固定

利用可能なオプション:
response
例:

"response"

​
created_at
number

作成時刻のUnixタイムスタンプ（秒）

例:

1771486674

​
model
string

実際に使用されたモデル名和版本

例:

"doubao-seed-2-0-code-preview-260215"

​
status
enum<string>

レスポンスステータス

  • completed: 生成完了
  • in_progress: 生成中
  • incomplete: 未完了
  • failed: 失敗
利用可能なオプション:
completed,
in_progress,
incomplete,
failed
例:

"completed"

​
output
(思考チェーン出力 · object | メッセージ出力 · object | ツール呼び出し出力 · object)[]

モデル出力コンテンツリスト，包含思考チェーン出力、メッセージ出力、ツール呼び出し出力等

​
service_tier
string

今回のリクエストのサービスティア

  • default: デフォルトサービスティア
  • scale: 保証パッケージ枠を使用
例:

"default"

​
instructions
string | null

このリクエストで使用されたシステム指示

​
previous_response_id
string | null

参照する前のレスポンスID

​
max_output_tokens
integer

モデル出力の最大トークン数

例:

32768

​
temperature
number | null

使用されたサンプリング温度

​
top_p
number | null

使用されたtop_p値

​
thinking
object

使用的思考モード配置

​
tools
array | null

使用的ツールリスト

​
tool_choice
any | null

使用されたツール選択設定

​
parallel_tool_calls
boolean | null

並列ツール呼び出しを許可するかどうか

​
text
object

テキスト出力形式設定

​
usage
object

トークン使用統計情報

​
caching
object

キャッシュ設定

​
store
boolean

レスポンスが保存されたかどうか

​
expire_at
integer

ストレージ有効期限（Unixタイムスタンプ）

例:

1756539922

​
error
object

エラー情報、成功時はnull

​
incomplete_details
object

未完了の詳細理由