과금과 호출 제한
언제 차감되고 언제 돌아오는가.
과금 기준
API 호출과 브라우저 작업은 같은 장부를 씁니다. 같은 계정, 같은 가격표이며 내역은 「지갑 → 수입·지출 내역」에 함께 기록되고 발생 출처는 구분됩니다.
- 이미지: 단가 × 장수. 단가는 선택한 사양, 사양이 없으면 모델 단가.
- 영상: 초당 크레딧 × 길이. 해상도가 높을수록 초당 단가가 오릅니다(/v1/models 의 specs 참고).
- 텍스트 대화: 토큰 단위. 입력과 출력 단가가 따로 있고, 올림 처리하며 호출당 최소 1포인트.
- 이미지와 영상은 완료 시점이 아니라 제출 시점에 차감하므로 동시에 제출해도 잔액을 초과해 쓰이지 않습니다. 텍스트는 생성이 끝나야 토큰 수를 알 수 있어 후불입니다(호출 전 잔액 기준선으로 먼저 걸러냅니다).
환원되는 경우
- 제출 단계에서 렌더러가 거절한 경우: 즉시 환원.
- 생성 도중 실패한 경우: 작업이 failed 로 바뀔 때 자동 환원.
- 아무도 폴링하지 않고 방치된 경우: 백그라운드 회수 처리가 마무리하며 환원.
- 결과가 마음에 들지 않는 경우: 환원 없음. 스튜디오 화면과 동일하며, 생성 자체에 실제 비용이 듭니다.
호출 제한
키마다 분당 최대 120회이며, 초과하면 429 rate_limit_exceeded 가 반환됩니다. 폭주한 스크립트를 막기 위한 값이라 정상적인 사용량으로는 닿지 않습니다. 폴링은 권장 간격을 지키고 밀리초 단위 루프로 만들지 마세요.
이 밖에 플랜에 따른 계정 단위 동시 실행 수와 일일 생성 한도가 적용되며, 429 concurrency_limit_reached 로 나타납니다.
429를 만나면 백오프하세요(대기 시간을 매번 두 배로 늘리는 식). 즉시 재시도하면 같은 벽에 다시 부딪힐 뿐입니다.

