API 접근

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

인증

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

콘텐츠 유형

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

응답 헤더

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"}
    ]
}'