인증

모든 /v1 엔드포인트에는 API 키가 필요합니다. /healthz, /readyz는 필요하지 않습니다.

키 보내기

두 헤더를 함께 보내면 같은 키여야 하며, 다르면 401 invalid_api_key가 반환됩니다. /v1/messages의 anthropic-version 헤더는 선택 사항이며, 보낼 때는 2023-06-01 같은 날짜여야 합니다.

인증 실패

키가 없거나, 잘못되었거나, 폐기되었거나, 만료된 경우 모두 동일한 401 invalid_api_key 응답이 반환됩니다. 그 밖에 403 ip_not_allowed, 403 org_suspended, 403 model_not_allowed, 429 key_cap_exceeded, 429 rate_limited가 있습니다. 같은 IP에서 인증 실패가 반복되면 일시적으로 제한됩니다.

폐기와 캐시

유효한 키는 게이트웨이에서 최대 10초 캐시되므로, 폐기한 키는 약 10초 안에 사용할 수 없게 됩니다.

브라우저 코드에 키를 넣지 말고 서버에서 API를 호출하세요. 자세한 내용은 영어 문서에 있습니다.