Source: https://aiprimetech.io/ko/docs/getting-started/authentication/

[홈](/ko/) / [문서](/ko/docs/) / 인증 

# 인증 

키를 전송하는 방법, 각 형식에 필요한 헤더, 키를 안전하게 보관하는 방법을 알아보세요. 

 페이지 복사 [ Markdown으로 보기](/ko/docs/getting-started/authentication.md) [ ChatGPT에 질문](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/getting-started/authentication.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Claude에서 질문](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/getting-started/authentication.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

모든 요청에는 대시보드에서 생성한 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는 이를 자동으로 설정합니다. 

```
Copy-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 키.
- 먼저 새 키를 생성하고 배포하세요.
- 트래픽이 새 키로 전환되면 기존 키를 삭제하세요. 기존 키를 사용하는 진행 중인 요청은 삭제 직후 실패합니다. 

[빠른 시작첫 호출 실행](/ko/docs/getting-started/quickstart/)[API 키 설정도구별 키 설정 위치](/ko/docs/guides/api-key-configuration/)[오류401와 402의 의미](/ko/docs/api-reference/errors/) 

[이전빠른 시작](/ko/docs/getting-started/quickstart/)[다음모델 및 키 그룹](/ko/docs/getting-started/models/)