API 키 및 인증
AGTCloud API 키를 만들고 관리하며 API에 필요한 인증 Header를 설정합니다.
API 키는 AGTCloud API 요청의 신원을 인증하는 데 사용합니다. 대부분의 API는 Bearer API 키를 사용합니다. Anthropic Messages 등의 호환 프로토콜은 전용 인증 Header를 사용하므로 자세한 요구 사항은 해당 엔드포인트 페이지를 기준으로 확인하세요.
| 설정 | 값 |
|---|---|
| Base URL | https://api.agtcloud.cn/v1 |
| 대부분의 API | Authorization: Bearer your-api-key |
| Anthropic Messages | x-api-key: your-api-key 및 anthropic-version: 2023-06-01 |
API 키 만들기
- API Keys로 이동합니다.
- API 키 만들기를 클릭합니다.
- API 키를 복사하여 안전하게 보관합니다.
API 키를 안전하게 보관하세요
스크린샷, 대화 기록, 지원 문의 또는 공개 코드에 전체 API 키를 표시하지 마세요. 유출이 의심되면 기존 키를 비활성화하거나 삭제하고 새 토큰을 추가하세요.
API 키 사용하기
Bearer 인증
Base URL로 https://api.agtcloud.cn/v1을 사용하고 요청에 다음 Header를 추가합니다:
Authorization: Bearer your-api-key권장 Base URL에는 이미 /v1이 포함되어 있습니다. 요청 주소를 조합할 때 /v1을 다시 추가하면 잘못된 경로가 생성됩니다.
API 키 확인하기
현재 API 키에 표시되는 모델 목록을 요청하여 Base URL과 인증 설정이 올바른지 확인합니다:
curl 'https://api.agtcloud.cn/v1/models' \
-H 'Authorization: Bearer your-api-key'Anthropic Messages
Anthropic Messages 호환 API를 호출할 때는 x-api-key로 API 키를 전달하고 필수 anthropic-version을 지정합니다:
x-api-key: your-api-key
anthropic-version: 2023-06-01전체 요청 요구 사항은 Anthropic Messages를 확인하세요.
API 키 관리하기
프로그래밍 방식의 API Key 관리
액세스 토큰 획득과 API Key 관리 절차를 확인하세요.
다음 작업은 API Keys 페이지에서 할 수 있습니다:
- 환경이나 애플리케이션별 토큰을 추가합니다.
- 더 이상 사용하지 않거나 유출이 의심되는 토큰을 비활성화합니다.
- 더 이상 필요하지 않은 토큰을 삭제합니다.
타사 도구 설정
OpenAI 호환 프로토콜을 사용하는 타사 도구를 설정할 때는 일반적으로 다음 항목을 입력합니다:
| 설정 항목 | 입력 내용 |
|---|---|
| API Host / Base URL | https://api.agtcloud.cn/v1 |
| API Key | 현재 계정에서 만든 API 키 |
| 모델 | 현재 사이트와 계정에서 사용 가능한 모델 ID |
모델 ID는 모델 목록에서 확인할 수 있습니다. 구체적인 설정 방법은 타사 통합을 확인하세요.
보안 관리
운영 서비스는 서버 환경 변수 또는 키 관리 서비스를 통해 API 키를 읽어야 합니다:
export AGTCLOUD_API_KEY='your-api-key'- API 키를 소스 코드에 기록하거나 버전 관리 시스템에 커밋하지 마세요.
- API 키를 브라우저 프런트엔드, 모바일 설치 패키지 또는 신뢰할 수 없는 클라이언트로 보내지 마세요.
- 개발, 테스트 및 운영 환경에서 서로 다른 API 키를 사용하세요.
- API 키 유출이 의심되면 즉시 기존 키를 비활성화하거나 삭제하고 새 키로 교체해야 합니다.