인증

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을 받을 수 있습니다.