인증

CheaperGen API는 비밀 API 키를 사용합니다. 인증이 필요한 모든 요청의 Authorization 헤더에 bearer token으로 키를 보내세요:

Authorization: Bearer cg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

키 만들기#

대시보드 → API 키로 이동해 키 만들기 버튼을 누르세요. 사용처를 알 수 있는 이름을 지정하세요(예: production-backend). 키는 cg_live_ 뒤에 무작위 32자가 붙는 형식입니다.

전체 API 키는 한 번만 표시됩니다. 키의 SHA-256 해시만 저장하므로 다시 확인할 수 없습니다. 키를 잃어버렸다면 기존 키를 해지하고 새 키를 만드세요. 대시보드에서 각 키의 접두사, 생성일, 마지막 사용 시점을 확인할 수 있습니다.

인증된 요청 보내기#

const resp = await fetch("https://cheapergen.com/api/v1/account", {
  headers: { Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}` },
});
console.log(await resp.json());

import os, requests

resp = requests.get(
    "https://cheapergen.com/api/v1/account",
    headers={"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"},
)
print(resp.json())

curl https://cheapergen.com/api/v1/account \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY"

공개 엔드포인트#

카탈로그 및 가격 엔드포인트는 키가 필요하지 않아 브라우저나 빌드 단계에서 호출할 수 있습니다: GET /api/v1/models, GET /api/v1/models/{vendor}/{model}, POST /api/v1/quote/{endpoint}. 생성 제출·조회·취소, 업로드, 계정 등 그 외 기능에는 키가 필요합니다. 전체 목록은 API 레퍼런스를 참고하세요.

키 안전하게 관리하기#

• 서버에서만 사용하세요. 모바일 앱, 브라우저 번들, 공개 저장소에 키를 포함하지 마세요. 키가 있으면 누구나 잔액을 사용할 수 있습니다.
• 환경 변수를 사용하세요. 또는 시크릿 관리 도구에 저장하세요. 소스 코드에 키를 직접 넣지 마세요. 이 문서의 예제는 CHEAPERGEN_API_KEY에서 읽어 옵니다.
• 환경이나 서비스마다 키를 하나씩 사용하세요. 그러면 다른 키에 영향을 주지 않고 해당 키만 해지할 수 있습니다.
• 키를 교체하려면 새 키를 만들고 배포한 뒤 기존 키를 해지하세요. 해지는 즉시 적용됩니다.

클라이언트 측 앱을 개발 중인가요?#

요청은 자체 백엔드를 통해 전달하세요. 서버가 키를 보관하고 사용자를 인증한 뒤 생성 요청을 전달합니다. 작업이 끝났을 때 알림을 받고 결과를 사용자에게 보낼 때는 웹훅을 사용하세요.

인증 오류#

키가 없거나 형식이 잘못되었거나 해지되면 401 unauthorized 오류가 반환됩니다:

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or revoked API key"
  }
}

자사 웹사이트(Studio와 모델 페이지의 플레이그라운드)에서 보낸 요청은 API 키 대신 로그인 세션으로 인증됩니다. 대시보드에는 출처가 playground 항목으로 표시됩니다.