만들 내용
POST /v1/messages로 요청을 한 번 보내고, Claude 응답 텍스트를 출력하며, Anthropic SDK 또는 직접 HTTP 사용을 위해 코드를 준비된 상태로 유지합니다.
사전 요구 사항
COMETAPI_KEY에 저장된 CometAPI API 키- Models page의 Claude model ID
curl, Python 3.10+ 또는 Node.js 18+
API 키, base URL, 인증
CometAPI를 통해 Anthropic 호환 Messages 엔드포인트를 사용합니다:x-api-key와 Anthropic API 버전 헤더로 인증합니다:
코드 예제
아래 탭에서 cURL, Python, Node.js의 복사 가능한 예제를 사용할 수 있습니다.흐름 설명
Claude Messages 요청은 기본적으로 동기식입니다. API는 하나의 HTTP 응답으로 message 객체를 반환하며, 애플리케이션은 첫 번째 텍스트 content 블록을 읽습니다. Anthropic 메시지 배열, extended thinking, prompt caching, tool use 같은 Claude 전용 요청 형태가 필요할 때 이 경로를 사용하세요. 애플리케이션이 이미 공식 Anthropic SDK를 사용 중이라면 SDK base URL을https://api.cometapi.com으로 설정하고 Messages API 요청 형태를 그대로 유지하세요.
공통 파라미터
문제 해결 / FAQ
요청이 401을 반환합니다
요청이 401을 반환합니다
요청을 보내는 동일한 셸 또는 런타임에
COMETAPI_KEY가 설정되어 있는지 확인하세요. 실제 키를 소스 파일에 붙여 넣지 마세요.SDK가 여전히 Anthropic을 직접 호출합니다
SDK가 여전히 Anthropic을 직접 호출합니다
SDK 클라이언트에서 Python은
base_url, Node.js는 baseURL을 https://api.cometapi.com으로 설정했는지 확인하세요.어떤 모델을 사용해야 하나요
어떤 모델을 사용해야 하나요
계정에서 사용할 수 있는 Claude model ID를 사용하세요. 이 빠른 시작 가이드는 계정과 모델 제품군에 따라 사용 가능 여부가 달라지므로 특정 Claude 모델을 하드코딩하지 않습니다.
다음 단계
- 전체 요청 및 응답 필드는 Anthropic Messages API reference에서 확인하세요.
- Models에서 모델 사용 가능 여부를 확인하세요.
- Claude Code integration guide로 로컬 코딩 세션을 구성하세요.
- Error codes and retry strategy에서 재시도 동작을 검토하세요.