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

##모든 API는 Bearer Token 인증이 필요합니다## **API Key 받기:** [API Key 관리 페이지](https://starmagic.ai/app/api-keys)를 방문하여 API Key를 받으세요 **요청 헤더에 추가:** ``` Authorization: Bearer YOUR_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"

입력 내용, 두 가지 형식 지원: **1. 텍스트 문자열**: 간단한 텍스트 입력 **2. 메시지 배열**: 다중 턴 대화 및 멀티모달 입력 지원

시스템 지시문, 모델의 역할 및 동작 설정 시스템 프롬프트와 유사하지만, 모델이 더 높은 우선순위로 따름

"string"

이전 응답 ID, 다중 턴 대화 구현에 사용 설정 시 서버가 자동으로 이전 대화 컨텍스트를 로드

"string"

모델 출력 최대 토큰 수 사고 체인 내용과 응답 내용 포함

32768

심층 사고 모드 제어

{
  "type": "enabled"
}

심층 사고의 작업량 제한, 줄이면 응답 속도가 빨라지고 토큰 사용량이 줄어듦

{
  "effort": "medium"
}

컨텍스트 캐시 활성화 여부 **참고**: instructions 필드, tools (Function Calling 제외) 필드와 함께 사용할 수 없습니다

{
  "type": "disabled",
  "prefix": false
}

생성된 모델 응답을 저장하여 나중에 API를 통해 검색할 수 있도록 할지 여부 - `true`: 현재 모델 응답 저장 - `false`: 저장하지 않음

true

응답 내용의 스트리밍 반환 여부 - `false`: 모델이 모든 내용을 생성한 후 한 번에 반환 - `true`: SSE 프로토콜에 따라 청크 단위로 반환, `data: [DONE]` 메시지로 종료

false

샘플링 온도, 출력 무작위성 제어 - 값 범위: [0, 2] - 낮은 값은 더 확정적, 높은 값은 더 무작위적 - temperature 또는 top_p 중 하나만 조정 권장 **참고**: doubao-seed-2.0-pro 및 doubao-seed-2.0-lite는 1로 고정, 수동 지정 시 무시됨

1

핵 샘플링 확률 임계값 - 값 범위: [0, 1] - temperature 또는 top_p 중 하나만 조정 권장 **참고**: doubao-seed-2.0-pro 및 doubao-seed-2.0-lite는 0.95로 고정, 수동 지정 시 무시됨

0.7

모델 텍스트 출력의 형식 정의

{
  "format": {
    "type": "text",
    "name": "string",
    "schema": {},
    "description": "string",
    "strict": false
  }
}

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

[
  {
    "type": "function",
    "name": "string",
    "description": "string",
    "parameters": {},
    "strict": true,
    "feature": {
      "chat": {
        "type": "disabled",
        "role_description": "string"
      },
      "deep_chat": {
        "type": "disabled",
        "role_description": "string"
      },
      "ai_search": {
        "type": "disabled",
        "role_description": "string"
      },
      "reasoning_search": {
        "type": "disabled",
        "role_description": "string"
      }
    },
    "user_location": {
      "type": "approximate",
      "city": "string",
      "country": "string",
      "region": "string",
      "timezone": "string"
    },
    "crop": {
      "type": "enabled"
    },
    "resize": {
      "type": "enabled"
    },
    "rotate": {
      "type": "enabled"
    },
    "server_label": "string",
    "server_url": "string",
    "headers": {},
    "require_approval": null,
    "allowed_tools": null,
    "knowledge_resource_id": "string",
    "doc_filters": {},
    "dense_weight": 0.5,
    "ranking_options": {
      "rerank_switch": false,
      "retrieve_count": 10,
      "score_threshold": 0,
      "score_threshold_enabled": false
    }
  }
]

컨텍스트 관리 전략, 긴 대화에서 컨텍스트 길이 초과 방지

{
  "type": "truncation",
  "retain": null,
  "exclude_tools": [
    "string"
  ],
  "clear_tool_input": false,
  "trigger": {
    "type": "token_count",
    "value": 0
  }
}