인증

게이트웨이 요청 인증 및 API 키 보안 모범 사례.

API 키 생성

콘솔에서 【API 키】 메뉴를 열고 충분한 할당량과 대상 모델 권한이 있는 키를 생성합니다. 예시의 YOUR_API_KEY를 해당 키로 교체하세요.

인증 헤더

업스트림 공급자 키가 아닌 게이트웨이 API 키를 사용하세요. Authorization 헤더에 Bearer 형식으로 전송합니다. 키는 서버 측에 안전하게 보관하고 프런트엔드 번들, 공개 저장소 또는 스크린샷에 노출되지 않도록 하세요.

Authorization: Bearer YOUR_API_KEY

문제 해결

인증 오류의 경우 키와 만료일을 확인하세요. 할당량 오류의 경우 잔액 및 키 한도를 확인하세요. 모델을 사용할 수 없는 경우 모델 ID 및 그룹 접근 권한을 확인하세요. 속도 제한의 경우 백오프를 적용하여 다시 시도하세요.