인증
AnyInt API 키를 사용하여 지원되는 각 API 프로토콜을 안전하게 인증합니다.
모든 개발자 API 요청에는 활성 AnyInt API 키가 필요합니다. 기존 OpenAI, Anthropic 및 Gemini SDK가 계속 작동하도록 클라이언트 프로토콜에서 예상하는 헤더를 사용하세요.
프로토콜별 권장 인증
| 프로토콜 | 권장 입력 | 표준 API 기본 주소 |
|---|---|---|
| OpenAI 호환 | Authorization: Bearer <AnyInt API Key> | https://api.anyint.ai/openai/v1 |
| Anthropic Messages | x-api-key: <AnyInt API Key> | https://api.anyint.ai/anthropic/v1 |
| Gemini 개발자 API | x-goog-api-key: <AnyInt API Key> | https://api.anyint.ai/gemini/v1beta |
| 비동기 미디어 | Authorization: Bearer <AnyInt API Key> | https://api.anyint.ai/v1/async-tasks |
클라이언트 호환성을 위해 게이트웨이는 프로토콜 제품군 전체에서 지원되는 AnyInt 키 헤더를 허용하며 Gemini 라우트에서 Gemini의 key 쿼리 매개변수를 허용합니다. 자격 증명이 URL이나 중간 로그에 나타나지 않도록 헤더를 사용하는 것이 좋습니다.
게이트웨이는 제공자 라우팅 전에 AnyInt 자격 증명을 소비합니다. 이 자격 증명을 업스트림 제공자 키로 전달하지 않습니다. 잘못되었거나 만료되었거나 취소된 키는 실패합니다.
키 생성
콘솔에서 API 키 생성 후 서버 측 비밀 관리자 또는 환경 변수에 저장하세요.
새로 발급된 AnyInt 키는 sk- 접두사 뒤에 52개의 Base64URL 문자가 붙습니다(총 55자). 기존 ak_ 키는 회전하거나 비활성화할 때까지 유효합니다. 콘솔에 표시된 전체 값을 항상 복사하세요. 접두사를 직접 추가하거나 제거하지 마세요.
export ANYINT_API_KEY="your_api_key"보안 지침
- 키를 서버 측 비밀 관리자 또는 환경 변수에 저장하세요.
- 프런트엔드 JavaScript, 소스 제어, 로그 또는 URL에 키를 넣지 마세요.
- 각 애플리케이션 및 환경에 대해 별도의 키를 사용하세요.
- 노출되었을 수 있는 키는 즉시 회전하세요.
- AnyInt 키를 업스트림 제공자로 전달하지 마세요.
인증 테스트
추론 요청을 보내기 전에 모델 목록을 가져와 키를 확인하세요.
curl "https://api.anyint.ai/openai/v1/models" \
--header "Authorization: Bearer $ANYINT_API_KEY"인증 실패 시 프로토콜 형식의 오류와 함께 HTTP 401이 반환됩니다. 유효한 키라도 잔액 부족으로 402을 받거나 적격 제공자가 없을 때 503을 받을 수 있습니다.
일반적인 오류 문제 해결
API 요청이 실패하면 다음 표를 참조하여 원인과 해결 방법을 빠르게 확인하세요.
| HTTP 상태 | 일반적인 원인 | 문제 해결 및 대처 방법 |
|---|---|---|
| 401 Unauthorized | 유효하지 않거나 만료된 API 키 또는 헤더 누락 | Bearer 토큰 또는 x-api-key 헤더를 확인하고, 콘솔 API 키에서 키가 활성 상태인지 확인하세요. |
| 402 Payment Required | 잔액 부족 또는 월간 예산 한도 도달 | 콘솔에서 크레딧을 충전하거나 API 키의 월간 예산 한도를 늘리세요. |
| 403 Forbidden | IP 제한, 환경 불일치 또는 권한 부족 | API 키 범위를 확인하고 클라이언트 IP가 허용된 IP 목록에 있는지 확인하세요. |
| 404 Not Found | 잘못된 엔드포인트 경로 또는 알 수 없는 모델 ID | Base URL 경로를 확인하고, GET /v1/models를 호출하여 모델 ID가 유효한지 확인하세요. |
| 429 Too Many Requests | 속도 제한(RPM/TPM) 또는 동시성 한도 도달 | 동시 요청 수를 줄이거나 지수 백오프 재시도를 구성하거나 콘솔에서 할당량 상향을 요청하세요. |
| 502 Bad Gateway | 업스트림 제공업체 네트워크 오류 또는 잘못된 응답 형식 | AnyInt 게이트웨이가 채널 간 페일오버를 자동으로 시도합니다. 문제가 지속되면 콘솔 요청 로그를 통해 문의하세요. |
| 503 Service Unavailable | 모든 라우팅 후보 채널을 일시적으로 사용할 수 없음 | 잠시 후 다시 시도하거나 동급의 대체 모델로 전환하세요. |
| 504 Gateway Timeout | 업스트림 추론 시간 초과(복잡한 추론 모델 등) | 프롬프트 복잡성을 확인하고 클라이언트 타임아웃을 늘리세요. 추론 모델에는 스트리밍(stream: true)을 권장합니다. |