12. Anthropic Messages 호환 엔드포인트#

POST /v1/messages — OpenAI 호환 파이프라인 위에 Anthropic Messages API 프로토콜 호환을 추가로 제공합니다. 하위 채널이 실제로 OpenAI인지 Anthropic인지와 무관하게 공식 Anthropic 클라이언트 / SDK로 구동할 수 있습니다. 비스트리밍과 스트리밍을 모두 지원합니다(스트리밍은 서버가 합성한 Anthropic SSE 이벤트 시퀀스).

인증 시 주의사항#

이 엔드포인트는 다른 엔드포인트와 동일하게 Authorization: Bearer sk-... 인증을 사용하며, Anthropic 기본값인 x-api-key 헤더는 받지 않습니다. 공식 Anthropic SDK 사용 시 키를 Bearer 헤더로 전달해야 합니다(예: SDK의 auth_token 파라미터 또는 커스텀 요청 헤더). 기본 api_key는 x-api-key를 전송하므로 사용하지 않습니다.

지원 범위#

• 지원: 텍스트 전용 messages, system 프롬프트, max_tokens, stream 등 기본 필드.
• 미지원: tools / tool_choice(함수 호출), 텍스트 외 콘텐츠 블록(이미지 등 멀티모달). 이러한 필드가 포함되면 조용히 버려지는 대신 즉시 400을 반환하며, 오류 본문은 Anthropic 형식입니다.
• 모든 오류(인증, 권한, 파라미터 포함)는 Anthropic 오류 형식으로 통일되어 반환됩니다.

curl http://183.240.79.21:52099/v1/messages \
  -H "Authorization: Bearer sk-你的YiTuoToken-Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "max_tokens": 256,
    "system": "你是一个简洁的助手。",
    "messages": [
      { "role": "user", "content": "用一句话介绍你自己" }
    ]
  }'

함수 호출 / 멀티모달 등 고급 기능이 필요하면 /v1/chat/completions(OpenAI 형식)을 사용하세요.