API 레퍼런스
출시 전 확인
프로덕션 트래픽을 받기 전에 이 체크리스트를 사용하세요. 키 보안, 재시도, 비동기 작업 지속성, 관측성, 과금을 하나의 출시 전 점검으로 묶어 줍니다.
#프로덕션 체크리스트
보안
- API 키는 신뢰할 수 있는 서버에 두세요. 영구 키를 브라우저나 모바일 바이너리에 포함해 배포하지 마세요.
- 프로젝트마다 범위가 제한된 키를 하나씩 쓰고 모델, IP, RPM, RPD, 한도 제한을 설정하세요.
- 모델 연동 코드를 바꾸지 않고 키를 교체하세요.
안정성
- 모든 요청에 연결 및 응답 타임아웃을 설정하세요.
- Retry-After를 따르고 지터를 포함한 지수 백오프를 사용하세요.
- 과금되는 비동기 제출에는 Idempotency-Key를 사용하고 task_id를 저장하세요.
관측성
- 요청 ID, 모델, 엔드포인트, 지연 시간, HTTP 상태, task_id를 기록하세요.
- 디버깅을 명시적으로 켜지 않았다면 프롬프트 내용을 로그에 남기지 마세요.
- 고객에게 보이는 실패를 해당 요청 로그 행과 연결하세요.
비용 관리
- 가격과 지원 옵션은 실시간 모델 메타데이터에서 읽으세요.
- 프로젝트별 한도 상한을 설정하고 지갑이 바닥나기 전에 알림을 보내세요.
- 요청 로그의 소수점 여섯째 자리까지 표시된 최종 사용 금액으로 대조하세요.
#출시 전 점검
- 1
최소 요청 테스트
워크벤치에서 정확한 모델과 엔드포인트로 실행한 뒤, 생성된 요청을 복사하세요.
- 2
실패 경로 테스트
401, 402, 429, 타임아웃, 잘못된 미디어, 작업 최종 실패 처리를 검증하세요.
- 3
과금 검증
성공한 요청을 소수점 여섯째 자리 사용 금액 및 요청 ID와 대조하세요.
- 4
모니터링 활성화
오류율, 지연 시간, 멈춘 작업, 웹훅 실패, 잔액 부족에 대해 알림을 설정하세요.
#운영 바로가기
아직 해결되지 않았나요?
요청 ID나 오류 메시지를 보내 주시면 확인해 드리겠습니다.