curl --request POST \
--url https://direct.evolink.ai/v1/chat/completions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "doubao-seed-2.0-pro",
"messages": [
{
"role": "user",
"content": "자기소개를 해주세요"
}
]
}
'{
"id": "0217714854126607f5a9cf8ed5b018c76e4ad3dc2810db57ffb50",
"model": "doubao-seed-2-0-pro-260215",
"object": "chat.completion",
"service_tier": "default",
"created": 1771485416,
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "안녕하세요! Doubao Seed 2.0은 바이트댄스가 출시한 차세대 대규모 언어 모델로, 더 강력한 추론, 멀티모달 이해 및 심층 사고 능력을 갖추고 있습니다.",
"reasoning_content": "<string>",
"tool_calls": [
{
"id": "<string>",
"type": "function",
"function": {
"name": "<string>",
"arguments": "<string>"
}
}
]
},
"finish_reason": "stop",
"logprobs": {
"content": [
{
"token": "<string>",
"bytes": [
123
],
"logprob": 123,
"top_logprobs": [
{
"token": "<string>",
"bytes": [
123
],
"logprob": 123
}
]
}
]
},
"moderation_hit_type": "severe_violation"
}
],
"usage": {
"total_tokens": 271,
"prompt_tokens": 15,
"prompt_tokens_details": {
"cached_tokens": 0
},
"completion_tokens": 256,
"completion_tokens_details": {
"reasoning_tokens": 0
}
}
}{
"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": "Image file too large",
"type": "request_too_large_error",
"param": "content",
"fallback_suggestion": "compress image to under 10MB"
}
}{
"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"
}
}Doubao Seed 2.0 - 전체 API 레퍼런스
- OpenAI SDK 형식으로 Doubao Seed 2.0 시리즈 모델 호출
- 동기 처리 모드, 실시간 응답
- 텍스트 채팅: 단일 또는 다중 턴 컨텍스트 대화
- 시스템 프롬프트: AI 역할 및 동작 사용자 정의
- 멀티모달 입력: 텍스트 + 이미지 + 비디오 혼합 입력 지원
- 심층 사고: 사고 체인 모드를 통한 심층 추론 지원
- 도구 호출: Function Calling 지원
- 구조화된 출력: JSON Object / JSON Schema 형식 출력 지원
- 빠르게 시작하시겠습니까? 빠른 시작 문서를 확인하세요
curl --request POST \
--url https://direct.evolink.ai/v1/chat/completions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "doubao-seed-2.0-pro",
"messages": [
{
"role": "user",
"content": "자기소개를 해주세요"
}
]
}
'{
"id": "0217714854126607f5a9cf8ed5b018c76e4ad3dc2810db57ffb50",
"model": "doubao-seed-2-0-pro-260215",
"object": "chat.completion",
"service_tier": "default",
"created": 1771485416,
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "안녕하세요! Doubao Seed 2.0은 바이트댄스가 출시한 차세대 대규모 언어 모델로, 더 강력한 추론, 멀티모달 이해 및 심층 사고 능력을 갖추고 있습니다.",
"reasoning_content": "<string>",
"tool_calls": [
{
"id": "<string>",
"type": "function",
"function": {
"name": "<string>",
"arguments": "<string>"
}
}
]
},
"finish_reason": "stop",
"logprobs": {
"content": [
{
"token": "<string>",
"bytes": [
123
],
"logprob": 123,
"top_logprobs": [
{
"token": "<string>",
"bytes": [
123
],
"logprob": 123
}
]
}
]
},
"moderation_hit_type": "severe_violation"
}
],
"usage": {
"total_tokens": 271,
"prompt_tokens": 15,
"prompt_tokens_details": {
"cached_tokens": 0
},
"completion_tokens": 256,
"completion_tokens_details": {
"reasoning_tokens": 0
}
}
}{
"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": "Image file too large",
"type": "request_too_large_error",
"param": "content",
"fallback_suggestion": "compress image to under 10MB"
}
}{
"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"
}
}https://direct.evolink.ai이며, 텍스트 모델 지원이 더 우수하고 장시간 연결을 지원합니다. https://api.evolink.ai는 멀티모달 서비스의 주력 엔드포인트이며, 텍스트 모델에 대해서는 대체 주소로 사용됩니다.인증
##모든 API는 Bearer Token 인증이 필요합니다##
API Key 받기:
API Key 관리 페이지를 방문하여 API Key를 받으세요
요청 헤더에 추가:
Authorization: Bearer YOUR_API_KEY
본문
채팅 모델 이름
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"
채팅 메시지 목록, 다중 턴 대화 및 멀티모달 입력 (텍스트, 이미지, 비디오) 지원
1Show child attributes
Show child attributes
모델의 심층 사고 모드 활성화 여부 제어
모델에 따라 지원 여부 및 기본값이 다릅니다
Show child attributes
Show child attributes
응답 내용의 스트리밍 반환 여부
false: 모델이 모든 내용을 생성한 후 한 번에 결과 반환true: SSE 프로토콜에 따라 모델 생성 내용을 청크 단위로 반환하며,data: [DONE]메시지로 종료. stream이 true일 때 stream_options 필드를 설정하여 토큰 사용량 통계를 받을 수 있습니다
false
스트리밍 응답 옵션. stream이 true일 때 이 필드를 설정할 수 있습니다
Show child attributes
Show child attributes
모델 응답 최대 길이 (토큰 단위)
참고:
- 모델 응답에는 사고 체인 내용이 포함되지 않습니다 (모델 응답 = 모델 출력 - 모델 사고 체인)
- 출력 토큰의 총 길이는 모델의 컨텍스트 길이 제한을 받습니다
- max_completion_tokens와 동시에 설정할 수 없습니다
4096
모델 출력의 최대 길이 제어, 모델 응답과 사고 체인 내용 길이 포함 (토큰 단위)
설명:
- 값 범위: [0, 65536]
- 설정 시 max_tokens 기본값이 무효화되며, 모델이 필요에 따라 내용 (응답 및 사고 체인)을 출력하다가 이 값에 도달하면 중단
- max_tokens와 동시에 설정할 수 없습니다
- 심층 사고 모드 활성화 시 이 매개변수 사용을 권장합니다
0 <= x <= 6553616384
샘플링 온도, 출력의 무작위성 제어
설명:
- 값 범위: [0, 2]
- 낮은 값 (예: 0.2): 더 확정적이고 집중된 출력
- 높은 값 (예: 0.8): 더 무작위적이고 창의적인 출력
- 값이 0이면 모델은 로그 확률이 가장 높은 하나의 토큰만 고려
- temperature 또는 top_p 중 하나만 조정하는 것을 권장합니다
0 <= x <= 20.7
핵 샘플링 확률 임계값
설명:
- 값 범위: [0, 1]
- 모델은 확률 질량이 top_p 이내인 토큰 결과를 고려
- 0.1은 확률 질량 상위 10%의 토큰만 고려함을 의미
- 값이 클수록 생성의 무작위성이 높아지고, 값이 작을수록 확정성이 높아짐
- temperature 또는 top_p 중 하나만 조정하는 것을 권장합니다
0 <= x <= 10.9
모델이 stop 필드에 지정된 문자열을 만나면 생성을 중단하며, 해당 단어 자체는 출력되지 않습니다. 최대 4개의 문자열 지원
참고: 심층 사고 모델은 이 필드를 지원하지 않습니다
["hello", "weather"]
사고의 작업량을 제한하여, 사고 깊이를 줄이면 속도가 향상되고 사고에 소비되는 토큰이 줄어듭니다
minimal: 사고 비활성화, 직접 답변low: 경량 사고, 빠른 응답 중심medium: 균형 모드, 속도와 깊이 모두 고려high: 심층 분석, 복잡한 문제 처리
minimal, low, medium, high "medium"
모델 응답 형식 지정
세 가지 형식 지원: text (기본값), json_object, json_schema
Show child attributes
Show child attributes
빈도 페널티 계수
설명:
- 값 범위: [-2.0, 2.0]
- 양수일 때, 텍스트에서 새 토큰의 출현 빈도에 따라 페널티를 부여하여 모델이 동일한 내용을 반복할 가능성을 줄임
-2 <= x <= 20
존재 페널티 계수
설명:
- 값 범위: [-2.0, 2.0]
- 양수일 때, 새 토큰이 현재까지 텍스트에 나타났는지 여부에 따라 페널티를 부여하여 모델이 새로운 주제를 다룰 가능성을 높임
-2 <= x <= 20
출력 토큰의 로그 확률 반환 여부
false: 로그 확률 정보를 반환하지 않음true: 메시지 내용의 각 출력 토큰에 대한 로그 확률 반환
참고: 심층 사고 모델은 이 필드를 지원하지 않습니다
각 출력 토큰 위치에서 반환할 가능성이 가장 높은 토큰 수 지정, 각 토큰에는 관련 로그 확률이 포함
- 값 범위: [0, 20]
- logprobs가 true일 때만 설정 가능
참고: 심층 사고 모델은 이 필드를 지원하지 않습니다
0 <= x <= 20지정된 토큰이 모델 출력 내용에 나타날 확률 조정
설명:
- map을 받으며, 키는 어휘의 토큰 ID, 값은 편향값
- 편향값 범위: [-100, 100]
- -1은 선택 가능성을 줄이고, 1은 선택 가능성을 높임
- -100은 해당 토큰 선택을 완전히 금지하고, 100은 해당 토큰만 선택 가능하게 함
참고: 심층 사고 모델은 이 필드를 지원하지 않습니다
Show child attributes
Show child attributes
호출할 도구 목록, 모델 반환 정보에 도구 호출 요청이 포함될 수 있습니다
Show child attributes
Show child attributes
이번 요청에서 모델 반환에 여러 호출 대기 도구를 포함할 수 있는지 여부
true: 여러 호출 대기 도구 반환 허용false: 반환되는 호출 대기 도구 수 <= 1
이번 요청에서 모델 반환 정보에 호출 대기 도구가 있는지 여부
문자열 모드:
none: 모델 반환 정보에 호출 대기 도구를 포함하지 않음required: 모델 반환 정보에 반드시 호출 대기 도구를 포함auto: 모델이 반환 정보에 호출 대기 도구 포함 여부를 자체 판단 (도구 존재 시 기본값)
객체 모드: 호출할 도구의 범위 지정
none, auto, required 응답
채팅 생성 성공
이번 요청의 고유 식별자
"0217714854126607f5a9cf8ed5b018c76e4ad3dc2810db57ffb50"
이번 요청에서 실제 사용된 모델 이름 및 버전
"doubao-seed-2-0-pro-260215"
응답 유형, chat.completion으로 고정
chat.completion "chat.completion"
이번 요청의 서비스 등급
default: 기본 서비스 등급scale: 보장 패키지 할당량 사용
default, scale "default"
이번 요청 생성 시간의 Unix 타임스탬프 (초)
1771485416
이번 요청의 모델 출력 내용
Show child attributes
Show child attributes
이번 요청의 토큰 사용량
Show child attributes
Show child attributes