인증
키를 전송하는 방법, 각 형식에 필요한 헤더, 키를 안전하게 보관하는 방법을 알아보세요.
모든 요청에는 대시보드에서 생성한 API 키가 필요합니다. 키는 다음으로 시작하며: sk- 해당 키를 생성한 계정의 권한과 잔액을 사용합니다.
두 가지 헤더, 하나의 키
동일한 키를 두 형식 모두에서 사용할 수 있으며, 헤더 이름만 달라집니다.
| 형식 | 엔드포인트 | 헤더 |
|---|---|---|
| Anthropic | /v1/messages | x-api-key: sk-... |
| Anthropic (alt) | /v1/messages | Authorization: Bearer sk-... |
| OpenAI | /v1/chat/completions | Authorization: Bearer sk-... |
Anthropic 형식에는 버전 헤더도 필요합니다. 모든 Anthropic SDK는 이를 자동으로 설정합니다.
-H "anthropic-version: 2023-06-01"환경 변수
대부분의 도구는 키를 인수로 받는 대신 다음 환경 변수를 읽습니다.
| 변수 | 사용 도구 | 값 |
|---|---|---|
ANTHROPIC_BASE_URL | Claude Code, Anthropic SDK | https://aiprimetech.io |
ANTHROPIC_AUTH_TOKEN | Claude Code | 사용자의 sk- 키 |
ANTHROPIC_API_KEY | Anthropic SDK (Python/TS) | 사용자의 sk- 키 |
OPENAI_BASE_URL | OpenAI SDK, LangChain, LiteLLM | https://aiprimetech.io/v1 |
OPENAI_API_KEY | OpenAI SDK | 사용자의 sk- 키 |
다음 항목에 주목하세요:
/v1 접미사는 다음에 붙이며: OPENAI_BASE_URL 다음에는 붙이지 않습니다: ANTHROPIC_BASE_URL. 이러한 차이는 공식 SDK의 동작에서 비롯되며, 저희가 도입한 것이 아닙니다. OpenAI 클라이언트는 지정한 기본 주소에 경로를 추가하고, Anthropic 클라이언트는 /v1 를 직접 추가합니다. 이를 잘못 설정하는 것이 가장 흔한 설정 오류입니다.키 관리 수칙
- 다음을 생성하세요. 기기 또는 프로젝트마다 별도의 키 를 사용하면 다른 키에 영향을 주지 않고 하나의 키만 폐기할 수 있습니다.
- 키를 절대 커밋하지 마세요. 환경 변수나 시크릿 관리 도구를 사용하고, 다음을 추가하세요:
.env다음으로 변경되었습니다..gitignore. - 키 전체가 표시되는 횟수는 한 번입니다. 분실한 키를 복구하려 하지 말고 새 키로 교체하세요.
- 유출된 키로 잔액이 소진될 수 있습니다. 대시보드에서 즉시 폐기하세요. 폐기는 즉시 적용됩니다.
- 서버 측 호출을 권장합니다. 브라우저 번들이나 모바일 앱에 포함된 키는 공개된 키입니다.
키 폐기 및 교체
- 대시보드 → API 키.
- 먼저 새 키를 생성하고 배포하세요.
- 트래픽이 새 키로 전환되면 기존 키를 삭제하세요. 기존 키를 사용하는 진행 중인 요청은 삭제 직후 실패합니다.