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": {
    "type": "enabled"
  },
  "store": true,
  "expire_at": 1756539922,
  "error": {},
  "incomplete_details": {}
}

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient quota",
    "type": "insufficient_quota_error",
    "fallback_suggestion": "https://evolink.ai/dashboard/billing"
  }
}

{
  "error": {
    "code": 403,
    "message": "Access denied for this model",
    "type": "permission_error",
    "param": "model"
  }
}

{
  "error": {
    "code": 404,
    "message": "Specified model not found",
    "type": "not_found_error",
    "param": "model",
    "fallback_suggestion": "doubao-seed-2.0-pro"
  }
}

{
  "error": {
    "code": 413,
    "message": "File too large",
    "type": "request_too_large_error",
    "fallback_suggestion": "compress file to under 50MB"
  }
}

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "fallback_suggestion": "retry after 60 seconds"
  }
}

{
  "error": {
    "code": 500,
    "message": "Internal server error",
    "type": "internal_server_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 502,
    "message": "Upstream AI service unavailable",
    "type": "upstream_error",
    "fallback_suggestion": "try different model"
  }
}

{
  "error": {
    "code": 503,
    "message": "Service temporarily unavailable",
    "type": "service_unavailable_error",
    "fallback_suggestion": "retry after 30 seconds"
  }
}

Responses API

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

Responses API形式でDoubao Seed 2.0シリーズモデルを呼び出し
サーバーサイドコンテキストストレージ：previous_response_idによるマルチターン会話を実現、手動で履歴メッセージを送信する必要なし
マルチモーダル入力：テキスト + 画像 + 動画 + ファイル（PDF）の混合入力に対応
ディープシンキング：thinking思考チェーンモードに対応
ツール呼び出し：Function Calling、ウェブ検索、画像処理、MCPツール、プライベートナレッジベース、Doubaoアシスタントに対応
コンテキストキャッシュ：cachingキャッシュメカニズムによるコスト削減に対応
構造化出力：JSON Object / JSON Schema形式に対応
コンテキスト管理：context_management戦略に対応
すぐに使い始めたいですか？クイックスタートをご覧ください

POST

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": {
    "type": "enabled"
  },
  "store": true,
  "expire_at": 1756539922,
  "error": {},
  "incomplete_details": {}
}

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient quota",
    "type": "insufficient_quota_error",
    "fallback_suggestion": "https://evolink.ai/dashboard/billing"
  }
}

{
  "error": {
    "code": 403,
    "message": "Access denied for this model",
    "type": "permission_error",
    "param": "model"
  }
}

{
  "error": {
    "code": 404,
    "message": "Specified model not found",
    "type": "not_found_error",
    "param": "model",
    "fallback_suggestion": "doubao-seed-2.0-pro"
  }
}

{
  "error": {
    "code": 413,
    "message": "File too large",
    "type": "request_too_large_error",
    "fallback_suggestion": "compress file to under 50MB"
  }
}

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "fallback_suggestion": "retry after 60 seconds"
  }
}

{
  "error": {
    "code": 500,
    "message": "Internal server error",
    "type": "internal_server_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 502,
    "message": "Upstream AI service unavailable",
    "type": "upstream_error",
    "fallback_suggestion": "try different model"
  }
}

{
  "error": {
    "code": 503,
    "message": "Service temporarily unavailable",
    "type": "service_unavailable_error",
    "fallback_suggestion": "retry after 30 seconds"
  }
}

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

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

Show child attributes

reasoning

object

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

Show child attributes

caching

object

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

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

Show child attributes

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

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

Show child attributes

tools

object[]

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

支持以下ツールタイプ：

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

Show child attributes

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

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

Show child attributes

レスポンス

レスポンス生成成功

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)[]

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

思考チェーン出力
メッセージ出力
ツール呼び出し出力

Show child attributes

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 | null

使用的思考モード配置

tools

array | null

使用的ツールリスト

tool_choice

any | null

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

parallel_tool_calls

boolean | null

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

text

object | null

テキスト出力形式設定

usage

object

トークン使用統計情報

Show child attributes

caching

object

キャッシュ設定

Show child attributes

store

boolean

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

expire_at

integer

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

例:

1756539922

error

object | null

エラー情報、成功時はnull

incomplete_details

object | null

未完了の詳細理由

画像シリーズ

動画シリーズ

オーディオシリーズ

テキストシリーズ

アカウント管理

タスク管理

ファイル管理

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

承認

ボディ

レスポンス