Doubao 매개변수 및 프로토콜 차이
호환 프로토콜에서 Doubao 모델의 매개변수 차이와 사용 방법을 알아봅니다.
Doubao는 이 페이지에 따라 조정하세요. 구조: Chat Completions, Responses, Messages.
| 모델 | 적용 범위 |
|---|
| doubao-seed-2-1-lite-260915, doubao-seed-evolving, doubao-seed-2-1-pro-260915 | 모두 세 프로토콜, 추론/도구 규칙 통합, 음성은 Lite 지원 범위만 |
| doubao-seed-evolving | 계속 갱신되는 ID로 특정 날짜 Pro 버전과 동일 취급하지 않음. 같은 Session 설정 안정 유지 |
| 필드 | 차이 설명 |
|---|
thinking.type | enabled/disabled 지원, 기본 추론 |
reasoning_effort | 기본 high, 실효 강도 low/medium/high, minimal는 끔. none→minimal, xhigh/max→high |
max_tokens | 기본 4096, 추론 없이 답변만 제한, 총예산 아님 |
max_completion_tokens | 추론/답변 포함, 공식 Chat 범위 1～65536, max_tokens과 배타. 모델 명세 최대 출력을 필드 한도로 사용하지 않음 |
temperature, top_p | 범위 [0,2], [0,1], 이전 Seed 2.0 일부의 온도 1 고정은 적용 안 함 |
frequency_penalty, presence_penalty | Seed 2.0 이후 미지원, 기능 제한이지 공식 폐기 아님 |
stop, logprobs | 깊은 추론 모델은 기본 미지원, 세 모델은 공식 예외 목록 아님 |
reasoning_content, encrypted_content | 기본 요약과 암호화 원문 반환. 도구 대화는 encrypted_content 그대로 재전송. 요약은 대체 불가, 함께 보내면 암호문 우선 |
stream_options.chunk_include_usage | 기본 false, true이면 블록별 누적 사용량 반환. 누적값을 다시 합산하지 않음 |
stream_options.include_usage | 마지막 총사용량 블록 제어. Lite는 기본 반환, 나머지는 활성화 필요. 블록 누적과 최종 합계는 별도 설정 |
response_format | json_object/json_schema 지원, 공식 Beta 유지. strict: true은 지원하는 Schema 부분집합만 제약, 모든 키워드 아님 |
| 필드 | 차이 설명 |
|---|
reasoning.effort | minimal/low/medium/high 및 호환 매핑, 기본 Chat과 같음. 요청 최상위 아님 |
max_output_tokens | 추론/답변 포함, Chat 답변만 예산이나 한도 사용하지 않음 |
text.format | JSON Schema는 text.format에 name/schema/strict, Qwen의 text.format.json_schema 중첩 구조 아님 |
store, previous_response_id | store 기본 true, 실제 응답 ID로 이력/원본 추론 연장. 이전 instructions 자동 상속 안 함 |
| 수동 이력 재전송 | 응답 ID 없이 reasoning, 메시지, 도구 전체 재전송, 암호문을 요약으로 대체하지 않음 |
max_tool_calls | 범위 1～10, 내장 도구 라운드 제한, 같은 라운드 횟수는 무제한. 최선 노력 제한이지 전체 함수의 엄격 총횟수 아님 |
service_tier, store | 원본 flex 모드에서 store은 false만, 서버 응답 저장 동시 불가 |
| 필드 | 차이 설명 |
|---|
max_tokens | 공식 선택 사항, Claude 필수와 다름. 예제는 명시 예산 유지 |
output_config.effort | 모델 기본값/매핑으로 강도 제어, Chat 최상위 필드를 옮기지 않음 |
output_format | 최상위 확장, text/json_object/json_schema 지원. Schema는 output_format.schema, Claude의 output_config.format 아님 |
temperature, top_p | 범위 [0,2], [0,1], top_p: 0도 유효 |
stop_sequences | 일반 필드는 문자열/배열을 받지만 깊은 추론은 기본 미지원. 필드 존재만으로 정지 보장 아님 |
| 이전 thinking 블록 | 실제 thinking, signature 전체, 값과 순서 유지. 서명 생성이나 요약으로 이력 재구성 금지 |
| 필드 | 차이 설명 |
|---|
| 암시적 캐시 | Chat / Responses 자동 활성화, 해제 불가. 같은 접두사 최소 1024 Token, 적중 보장 안 함 |
prompt_cache_key | Chat / Responses 라우팅 힌트, 대화 내 일정 유지. 같은 키가 같은 인스턴스/적중 보장 아님 |
Responses caching | 원본 명시 캐시 확장, type: "enabled"으로 켬. prefix: true은 접두사만 기록, false는 생성과 기록 |
caching 조합 제한 | instructions이나 Function 이외 tools과 병용 불가, 다른 TTL/Session Header는 사용하지 않음 |
| 캐시 사용량 | Chat usage.prompt_tokens_details.cached_tokens, Responses usage.input_tokens_details.cached_tokens, Messages 실제 usage.cache_read_input_tokens, usage.cache_creation_input_tokens |
MODEL_ID을 전체 ID로 바꾸고 본인 API Key를 사용하세요.
curl 'https://api.agtcloud.ai/v1/chat/completions' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "API 시간 초과 진단 방법을 세 가지로 설명하세요"}],
"reasoning_effort": "low",
"max_completion_tokens": 4096
}'