Anthropic Messages API: Claude Code에서 Tokuse 사용하기

Anthropic Messages 형식의 요청을 받아 업스트림 모델로 전달하는 엔드포인트입니다. Claude Code처럼 Anthropic 프로토콜을 쓰는 클라이언트에서 base URL만 Tokuse로 바꾸면 됩니다. 요금은 입력·출력 토큰 기준이며, 최신 단가는 Tokuse 요금 페이지에서 확인하세요.

엔드포인트와 인증

항목	값
메서드	POST
엔드포인트	/v1/messages
인증	Authorization: Bearer sk-your-tokuse-key 또는 x-api-key: sk-your-tokuse-key

Claude Code에서는 base URL 항목에 https://tokuse.com을 넣고, API 키에는 Tokuse 키를 사용합니다.

설정	값
ANTHROPIC_BASE_URL	https://tokuse.com
API 키	sk-your-tokuse-key

지원 모델

Anthropic Messages 형식으로 호출할 수 있는 모델 별칭 예시입니다. 실제 목록은 Tokuse 콘솔에서 확인하세요.

• deepseek-v4-pro
• deepseek-v4-1-flash
• kimi-k3-1-pro

요청 예시

curl https://tokuse.com/v1/messages \
  -H "x-api-key: sk-your-tokuse-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-1-flash",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Anthropic Messages 형식으로 짧게 인사해 줘."}
    ]
  }'

응답 예시

{
  "id": "msg_01j...",
  "type": "message",
  "role": "assistant",
  "model": "deepseek-v4-1-flash",
  "content": [
    {"type": "text", "text": "안녕하세요. 무엇을 도와드릴까요?"}
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 24,
    "output_tokens": 18
  }
}

주의 사항과 제한

• ANTHROPIC_BASE_URL에는 https://tokuse.com만 넣습니다. /v1을 붙이면 클라이언트가 /v1/v1/messages로 호출합니다.
• Authorization: Bearer와 x-api-key 헤더를 모두 지원합니다. 기존 Anthropic 클라이언트의 인증 방식을 그대로 쓸 수 있습니다.
• 업스트림을 화산 /api/compatible 경로로 라우팅하는 구성도 지원합니다.
• Anthropic Messages 형식에서는 max_tokens가 필수입니다. 생략하면 요청이 거부될 수 있습니다.

요금

과금은 입력 토큰과 출력 토큰을 기준으로 계산됩니다. Claude Code처럼 대화가 길어지는 클라이언트는 대화가 누적될수록 입력 토큰이 늘어납니다. 실제 단가는 Tokuse 요금 페이지(/pricing)와 업스트림 콘솔에서 확인하세요.