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,
  "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": 1771745874,
  "error": {}
}

{
  "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,
  "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": 1771745874,
  "error": {}
}

{
  "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 Key 받기:

API Key 관리 페이지를 방문하여 API Key를 받으세요

요청 헤더에 추가:

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

필수

입력 내용, 두 가지 형식 지원:

1. 텍스트 문자열: 간단한 텍스트 입력

2. 메시지 배열: 다중 턴 대화 및 멀티모달 입력 지원

instructions

string | null

시스템 지시문, 모델의 역할 및 동작 설정

시스템 프롬프트와 유사하지만, 모델이 더 높은 우선순위로 따름

previous_response_id

string | null

이전 응답 ID, 다중 턴 대화 구현에 사용

설정 시 서버가 자동으로 이전 대화 컨텍스트를 로드

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

도구 목록, 다양한 도구 유형 지원

Show child attributes

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

사용된 핵 샘플링 확률

usage

object

토큰 사용 통계 정보

Show child attributes

caching

object

캐시 설정

Show child attributes

store

boolean

응답 저장 여부

예시:

true

expire_at

integer

저장 만료 시간 (Unix 타임스탬프)

예시:

1771745874

error

object | null

오류 정보, 성공 시 null

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

Doubao Seed 2.0 Responses API - 전체 API 레퍼런스

인증

본문

응답