​
API 접근

API는 웹 Console을 통해 제공됩니다. Workbench를 사용하여 브라우저에서 API를 시도해보고 계정 설정에서 API 키를 생성할 수 있습니다. 워크스페이스를 사용하여 API 키를 분할하고 사용 사례별로 지출을 제어하세요.

​
인증

Anthropic API에 대한 모든 요청은 API 키와 함께 x-api-key 헤더를 포함해야 합니다. Client SDK를 사용하는 경우, 클라이언트를 구성할 때 API를 설정하면 SDK가 모든 요청에서 대신 헤더를 전송합니다. API와 직접 통합하는 경우, 이 헤더를 직접 전송해야 합니다.

​
콘텐츠 유형

Anthropic API는 항상 요청 본문에서 JSON을 받아들이고 응답 본문에서 JSON을 반환합니다. 요청에서 content-type: application/json 헤더를 전송해야 합니다. Client SDK를 사용하는 경우, 이는 자동으로 처리됩니다.

​
요청 크기 제한

API는 Messages API 및 Token Counting API를 포함한 표준 엔드포인트에 대해 최대 요청 크기가 32MB입니다. 이 제한을 초과하면 Cloudflare에서 413 request_too_large 오류를 받게 됩니다. 특정 엔드포인트는 다른 제한이 있습니다:
  • 표준 엔드포인트 (Messages, Token Counting): 32MB
  • Batch API: 256MB
  • Files API: 500MB

​
응답 헤더

Anthropic API는 모든 응답에 다음 헤더를 포함합니다:
  • request-id: 요청에 대한 전역적으로 고유한 식별자입니다.
  • anthropic-organization-id: 요청에 사용된 API 키와 연결된 조직 ID입니다.

​
예제

Shell
curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Hello, world"}
    ]
}'