Claude

Endpoint: https://mmu.vod-qcloud.com/v1인증: VOD ApiToken / Bearer

기본 정보

항목	값
호출 주소	https://mmu.vod-qcloud.com
인증	VOD 애플리케이션에서 발급한 ApiToken / Bearer
출력	텍스트 / 구조화된 응답
응답 방식	JSON / SSE

지원 프로토콜

규격	경로	대상
Chat Completions	POST /v1/chat/completions	아래 모든 모델
Messages	POST /v1/messages	아래 모든 모델

아래 모델 ID에 해당 규격을 사용합니다. 인증과 공통 필드는 API Reference를 따릅니다.

샘플링 옵션

이 문서에 나열된 모든 모델에 공통으로 적용됩니다.

파라미터	설정
temperature	설정 가능
top_p	설정 가능
top_k	설정 가능

temperature는 샘플링 온도, top_p는 누적 확률 범위를 지정합니다. 한 가지 방식을 중심으로 조정합니다.

top_k는 샘플링 후보 토큰 수를 제한합니다. 위 표는 Messages 규격 기준입니다.

버전별 추론 설정

모델 ID	설정 방식	비활성화
cd-fable-5.1	adaptive	disabled
cd-fable-5	enabled / budget_tokens adaptive	비활성화 불가
cd-opus-5.5	enabled / budget_tokens adaptive	비활성화 불가
cd-opus-5	enabled / budget_tokens adaptive	disabled
cd-opus-4.8	enabled / budget_tokens adaptive	disabled
cd-opus-4.7	enabled / budget_tokens adaptive	disabled
cd-opus-4.6	adaptive	disabled
cd-opus-4.5	enabled / budget_tokens	disabled
cd-sonnet-5	enabled / budget_tokens adaptive	disabled
cd-sonnet-4.6	enabled / budget_tokens adaptive	disabled
cd-sonnet-4.5	enabled / budget_tokens	disabled
cd-haiku-4.5	enabled / budget_tokens	disabled

Messages의 최상위 thinking 객체에 설정합니다. enabled는 budget_tokens를 함께 지정하며 max_tokens보다 작아야 합니다. adaptive는 모델이 추론량을 조절합니다. 적응형 추론에서는 입력과 모델에 따라 추론 블록이 생략될 수 있습니다. 최종 답변은 텍스트 블록에서 읽습니다.

요청 파라미터

파라미터	필수	타입	설명
model	필수	String	버전별 옵션 표의 모델 ID
messages	필수	Array	Chat Completions / Messages의 대화 입력
max_tokens	선택	Integer	Chat Completions / Messages의 생성 한도. Messages에서는 필수
stream	선택	Boolean	true: SSE / false: JSON

요청 예시

Chat Completions

{
  "model": "cd-opus-5.5",
  "messages": [
    {
      "role": "user",
      "content": "Reply with exactly OK and nothing else."
    }
  ],
  "max_tokens": 2048,
  "stream": false
}

응답

{
  "id": "msg_011CfSFyyYNpz8g33KDmPPtv",
  "object": "chat.completion",
  "model": "claude-opus-5-5",
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "OK",
        "role": "assistant"
      }
    }
  ],
  "usage": {
    "completion_tokens": 4,
    "prompt_tokens": 23,
    "total_tokens": 27,
    "prompt_tokens_details": {
      "cache_creation": {
        "ephemeral_1h_input_tokens": 0,
        "ephemeral_5m_input_tokens": 0
      }
    }
  }
}

Messages

{
  "model": "cd-sonnet-5",
  "messages": [
    {
      "role": "user",
      "content": "Reply with exactly OK and nothing else."
    }
  ],
  "max_tokens": 512,
  "stream": false
}

응답

{
  "id": "msg_bdrk_2ezgj47ifxmqxs62sozyw2mvdhf3il2zdpt6gynvzaq52q7d64da",
  "model": "claude-sonnet-5",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "OK"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 21,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "cache_creation": {
      "ephemeral_5m_input_tokens": 0,
      "ephemeral_1h_input_tokens": 0
    },
    "output_tokens": 4,
    "output_tokens_details": {
      "thinking_tokens": 0
    },
    "service_tier": "standard"
  }
}

특수 설정

Chat Completions의 대화 지침은 messages에 포함하고, Messages에서는 최상위 system 필드로 전달합니다. Messages 응답은 content의 type=text 블록을 읽습니다.

적응형 추론을 사용하는 Claude 버전의 네이티브 Messages 설정은 thinking.type=adaptive입니다. 고정 예산 방식은 thinking.type=enabled와 budget_tokens를 사용하며 예산은 max_tokens보다 작아야 합니다. 추론 설정은 Messages의 thinking 객체에 지정합니다.

버전별 추가 옵션

도구는 input_schema로 정의합니다. 응답의 tool_use에 대응하는 결과를 tool_result로 전달합니다.

Messages 추론 요청

cd-opus-5.5

{
  "model": "cd-opus-5.5",
  "messages": [
    {
      "role": "user",
      "content": "Find the smallest positive integer n for which n squared is divisible by 72. Explain briefly."
    }
  ],
  "max_tokens": 2048,
  "stream": false,
  "thinking": {
    "type": "adaptive"
  }
}

cd-sonnet-5

{
  "model": "cd-sonnet-5",
  "messages": [
    {
      "role": "user",
      "content": "Find the smallest positive integer n for which n squared is divisible by 72. Explain briefly."
    }
  ],
  "max_tokens": 2048,
  "stream": false,
  "thinking": {
    "type": "adaptive"
  }
}

응답의 content에서 type=thinking과 type=text를 구분합니다. 추론 블록의 서명은 후속 대화에서 원형을 유지합니다.