Skip to main content
POST
Responses API with Seed 2.1 Turbo (native multi-turn / explicit cache)
右側の Playground を使ってください: AuthorizationBearer sk-your-api-key を入れ、input を入力して送信します。レスポンスの output 配列では、type: "reasoning" 項目が推論サマリーで、type: "message" が実際の回答です。
マルチターン会話では、前回レスポンスの idresp_ プレフィックス)を次回呼び出しの previous_response_id として渡してください。履歴を再送する必要はありません。明示的なキャッシュと推論制御については、Seed 2.1 Turbo 概要 で説明しています。
  • 小さな max_output_tokens は推論に消費され、status: "incomplete"空のテキストで返ってきます — 1500 から始めてください
  • 明示的なキャッシュ caching: {"type": "enabled"} は、連結previous_response_id 経由した場合にのみヒットします。同じプレフィックスを繰り返してもヒットせず、暗黙のプレフィックスキャッシュも無効になります

パラメータのクイックリファレンス

レスポンスのハイライト

  • statusincomplete の場合は、incomplete_details.reason を確認してください(通常は length: 推論が予算を使い切っています)
  • 推論の消費量: usage.output_tokens_details.reasoning_tokens
  • キャッシュヒット: usage.input_tokens_details.cached_tokens(連続した2ターン目では、テストで直前までのコンテキスト全体にヒットし、レイテンシはおおむね半減しました)
  • レスポンスの caching フィールドには、実際に有効なキャッシュモードが反映されます

承認

Authorization
string
header
必須

API Key from the APIYI console

ボディ

application/json
model
enum<string>
デフォルト:dola-seed-2-1-turbo-260628
必須

Model ID, fixed to dola-seed-2-1-turbo-260628

利用可能なオプション:
dola-seed-2-1-turbo-260628
input
string
必須

Input content. Either a string or a message array ([{role, content}, ...], including function_call_output items)

:

"Introduce yourself in one sentence"

max_output_tokens
integer
デフォルト:1500

Max output tokens (thinking included). Too small yields incomplete with empty text - use 1500+

reasoning
object

Thinking depth control. Measured: effort low ~371, high ~1317 reasoning tokens

previous_response_id
string

Previous response id (resp_ prefix) for native multi-turn; combine with caching.enabled for explicit cache hits

caching
object

Explicit cache switch. enabled only hits when chained via previous_response_id

store
boolean

Whether to store this response for later previous_response_id reference

stream
boolean
デフォルト:false

Stream via SSE (response.created → response.output_text.delta → response.completed)

text
object

Structured output. Supports {"format": {"type": "json_schema", name, strict, schema}}

tools
object[]

Function-calling tool list (flat Responses format: {type, name, description, parameters})

レスポンス

Generation succeeded. The output array contains reasoning and message items

id
string

Response ID (resp_ prefix), usable as the next turn's previous_response_id

status
string

completed / incomplete (incomplete when thinking eats the token budget)

output
object[]

Output items: reasoning (thinking summary), message (text), function_call, etc.

usage
object

Usage. output_tokens_details.reasoning_tokens = thinking spend; input_tokens_details.cached_tokens = cache hits

caching
object

The cache mode actually in effect for this request