Doubao Seed 시리즈

ByteDance의 Doubao Seed 텍스트 모델로 Seed 2.1 Pro, Seed 2.1 Turbo, Seed Evolving, Seed Character가 있습니다. OpenAI 호환 API로 호출하며, Seed Character를 제외하면 Anthropic 네이티브 API도 지원하므로 Claude Code에서 사용할 수 있습니다. Doubao의 이미지 생성 모델은 Seedream(Doubao)을, 동영상 모델은 Seedance를 참고하십시오.

주요 작업

모델

전체 모델 목록과 실시간 가격은 모델 페이지 를 참고하십시오. 모델 ID의 접두사는 volcengine/이며 생략할 수 있습니다. bytedance/, doubao/ 접두사나 Volcano Engine Ark의 날짜 포함 모델 이름으로 쓰면 404가 반환됩니다.

위 모델은 Volcano Engine(volcengine)이 제공하며, 모두 Chat Completions와 Responses API를 지원합니다.

호출 예시

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="volcengine/doubao-seed-2.1-pro",
    messages=[{"role": "user", "content": "멱등성이 무엇인지 한 문장으로 설명해 주세요."}],
    extra_body={"thinking": {"type": "disabled"}},
)
print(resp.choices[0].message.content)

curl https://api.ofox.ai/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volcengine/doubao-seed-2.1-pro",
    "messages": [{"role": "user", "content": "멱등성이 무엇인지 한 문장으로 설명해 주세요."}],
    "thinking": {"type": "disabled"}
  }'

심층 사고

• thinking.type은 enabled와 disabled를 지원하며, auto를 전달하면 400이 반환됩니다.
• 「멱등성이 무엇인지 한 문장으로 설명해 주세요」로 실측한 결과, Seed 2.1 Pro는 기본 설정으로 약 1500 토큰을 사고하며 약 40초가 걸렸고, Seed Evolving은 약 1700 토큰, 약 54초가 걸렸습니다. 사고를 끄면 약 2초 만에 응답했습니다.
• 사고 토큰은 max_tokens에 포함됩니다. 상한을 너무 작게 설정하면 content가 비어 있고 finish_reason이 length가 될 수 있습니다.
• 사고 토큰은 출력 단가로 과금되며, 수량은 usage.completion_tokens_details.reasoning_tokens에서 확인할 수 있습니다.

사고 내용 읽기: 스트리밍 응답에서는 delta.reasoning_content에 있고, 비스트리밍 응답에서는 message.reasoning_details에 있으므로 각 항목의 text를 순서대로 이어 붙이십시오.

Claude Code에서 사용

Seed 2.1 Pro, Seed 2.1 Turbo, Seed Evolving은 Anthropic 네이티브 API를 지원하며, 주소는 https://api.ofox.ai/anthropic입니다.

• Anthropic API로 호출할 때 thinking 파라미터를 전달하지 않으면 사고 내용이 반환되지 않습니다. 사고가 필요하면 "thinking": {"type": "enabled", "budget_tokens": 2000} 또는 {"type": "adaptive"}를 전달하십시오. 사고 내용은 thinking 블록으로 반환됩니다.
• Seed Character는 Anthropic API를 지원하지 않으며, 호출하면 protocol_not_supported가 반환됩니다.

Claude Code의 전체 설정 방법은 Claude Code 설정을 참고하십시오.

이미지 입력과 구조화된 출력

• 이미지 입력: 위 모델은 모두 이미지 입력을 지원하며, 표준 image_url 콘텐츠 블록을 사용합니다. 작성법은 비전을 참고하십시오. 이미지 링크는 공용 인터넷에서 빠르게 다운로드할 수 있어야 하며, 그렇지 않으면 Timeout while downloading url이 반환됩니다. base64 데이터를 사용할 수도 있습니다.
• 구조화된 출력: response_format은 json_schema와 json_object를 지원합니다. 작성법은 구조화된 출력을 참고하십시오.
• 도구 호출: 표준 tools 파라미터를 사용하며 tool_calls를 반환합니다.

자주 발생하는 오류

기타 일반 오류는 오류 처리를 참고하십시오.

공식 문서

• Volcano Engine Ark · 문서 

자주 묻는 질문