API 레퍼런스

결제 및 잔액

지갑 잔액에서 차감하며 호출마다 정산합니다. 토큰 기준 모델은 입력·출력 토큰 100만 개당 과금되고, 이미지 / 동영상 / 작업형 모델은 요청당 과금됩니다. 실패한 요청은 자동으로 환불됩니다.

#토큰당 요금

입력 토큰과 출력 토큰은 따로 계량됩니다. 모델별 전체 가격은 /models 카드에 표시되며, 완료된 각 요청의 최종 실제 사용 금액은 요청 로그에 표시됩니다.

usage.json

{
  "usage": {
    "prompt_tokens": 128,
    "completion_tokens": 402,
    "total_tokens": 530
  }
}

요청 시작 시 한도를 사전 차감하고(max_tokens 기준 최대 추정치), 응답이 끝나면 제공업체가 보고한 사용량에 맞춰 정산합니다 — 실제 사용량만큼만 지불합니다.

이미지, 동영상, TTS 등 작업형 모델은 성공한 호출마다 고정 가격을 부과합니다. 해상도나 길이에 따라 가격이 다를 수 있으니 — 항상 모델 카드를 먼저 확인하세요.

요청당 과금 모델은 한 모델에 여러 요금 구간을 둘 수 있습니다. 이미지 구간은 size와 quality, 동영상 구간은 길이와 해상도로 정해집니다. 구간은 제출 시 요청 파라미터로 결정되며, 각 구간의 가격은 모델 카드에 나와 있습니다.

구간별 요금

size, quality, duration이 과금 구간을 결정합니다 — 모델 카드에 구간별 정확한 가격이 있으며, 실패한 호출은 자동 환불됩니다.

요청이 실패하거나 비동기 작업이 끝내 완료되지 않으면 사전 차감된 한도가 자동으로 반환됩니다. 요청 로그에는 최종 실제 사용 금액만 표시되므로, 실패한 호출이 별도의 차감과 환불로 보이지 않습니다.

모든 사용량은 하나의 선불 지갑에서 정산됩니다 — 후불 청구는 없습니다. 키에 자체 한도 상한이 없다면 모든 키가 같은 잔액을 사용합니다.

콘솔 → 지갑에서 충전하세요. 사용 가능한 결제 수단(카드 / 기타 제공업체)과 최소 충전 금액은 결제 화면에 표시됩니다. 교환 코드도 같은 곳에서 적용할 수 있으며 즉시 반영됩니다.

잔액은 만료되지 않습니다. 결제가 성공했는데 몇 분이 지나도 잔액이 바뀌지 않으면 결제 참조 번호와 함께 문의 티켓을 여세요.

잔액이 요청의 사전 차감 추정액보다 부족하면 호출은 402 insufficient_quota로 즉시 실패합니다 — 아무것도 과금되지 않습니다. 충전 후 다시 시도하세요. 이미 진행 중인 긴 스트림은 응답 도중에 끊기지 않습니다.

콘솔 → 사용량에서 모델별·일별 토큰과 지출을 키별로 나눠 차트로 보여 줍니다 — 어떤 프로젝트나 모델이 비용을 키우는지 가장 빨리 확인하는 방법입니다.

콘솔 → 요청 로그는 고객이 확인하는 API 지출의 기준입니다. 각 행에는 시각, 모델, 토큰 사용량 또는 호출 가격, 요청 ID, 최종 실제 사용 금액이 들어 있습니다.

요청 로그의 각 행에는 요청 식별자와 타임스탬프가 있습니다. 특정 호출에 대해 문의 티켓을 제출할 때는 해당 행(시각, 모델, 요청 ID)을 함께 적어 주세요 — 지원팀이 정확한 업스트림 시도를 추적할 수 있습니다.

프롬프트는 저장되지 않음

게이트웨이는 메타데이터(모델, 토큰, 비용, 타임스탬프, 요청 ID)만 저장합니다 — 프롬프트 내용은 저장하지 않으며, 디버깅을 위해 요청 로깅을 명시적으로 켠 경우만 예외입니다.

아직 해결되지 않았나요?

요청 ID나 오류 메시지를 보내 주시면 확인해 드리겠습니다.