Skip to main content
POST
Responses API with Seed 2.1 Turbo (native multi-turn / explicit cache)
오른쪽 플레이그라운드를 사용하십시오: 인증Bearer sk-your-api-key을 넣고, input를 입력한 다음 전송하십시오. 응답의 output 배열에서, type: "reasoning" 항목은 추론 요약이며 — type: "message"는 실제 답변입니다.
멀티턴 대화에서는 이전 응답의 id(resp_ 접두사)를 다음 호출의 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