인증

AnyInt API 키를 사용하여 지원되는 각 API 프로토콜을 안전하게 인증합니다.

모든 개발자 API 요청에는 활성 AnyInt API 키가 필요합니다. 기존 OpenAI, Anthropic 및 Gemini SDK가 계속 작동하도록 클라이언트 프로토콜에서 예상하는 헤더를 사용하세요.

프로토콜별 권장 인증

프로토콜권장 입력표준 API 기본 주소
OpenAI 호환Authorization: Bearer <AnyInt API Key>https://api.anyint.ai/openai/v1
Anthropic Messagesx-api-key: <AnyInt API Key>https://api.anyint.ai/anthropic/v1
Gemini 개발자 APIx-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_ 키는 회전하거나 비활성화할 때까지 유효합니다. 콘솔에 표시된 전체 값을 항상 복사하세요. 접두사를 직접 추가하거나 제거하지 마세요.

bash
export ANYINT_API_KEY="your_api_key"

보안 지침

  • 키를 서버 측 비밀 관리자 또는 환경 변수에 저장하세요.
  • 프런트엔드 JavaScript, 소스 제어, 로그 또는 URL에 키를 넣지 마세요.
  • 각 애플리케이션 및 환경에 대해 별도의 키를 사용하세요.
  • 노출되었을 수 있는 키는 즉시 회전하세요.
  • AnyInt 키를 업스트림 제공자로 전달하지 마세요.

인증 테스트

추론 요청을 보내기 전에 모델 목록을 가져와 키를 확인하세요.

bash
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 ForbiddenIP 제한, 환경 불일치 또는 권한 부족API 키 범위를 확인하고 클라이언트 IP가 허용된 IP 목록에 있는지 확인하세요.
404 Not Found잘못된 엔드포인트 경로 또는 알 수 없는 모델 IDBase URL 경로를 확인하고, GET /v1/models를 호출하여 모델 ID가 유효한지 확인하세요.
429 Too Many Requests속도 제한(RPM/TPM) 또는 동시성 한도 도달동시 요청 수를 줄이거나 지수 백오프 재시도를 구성하거나 콘솔에서 할당량 상향을 요청하세요.
502 Bad Gateway업스트림 제공업체 네트워크 오류 또는 잘못된 응답 형식AnyInt 게이트웨이가 채널 간 페일오버를 자동으로 시도합니다. 문제가 지속되면 콘솔 요청 로그를 통해 문의하세요.
503 Service Unavailable모든 라우팅 후보 채널을 일시적으로 사용할 수 없음잠시 후 다시 시도하거나 동급의 대체 모델로 전환하세요.
504 Gateway Timeout업스트림 추론 시간 초과(복잡한 추론 모델 등)프롬프트 복잡성을 확인하고 클라이언트 타임아웃을 늘리세요. 추론 모델에는 스트리밍(stream: true)을 권장합니다.