Estimate API

이미지·비디오·음악 생성 요청을 보내기 전에 몇 크레딧이 차감될지 알려 줍니다.

견적은 실제 차감과 같은 계산으로 나옵니다 — 같은 모델 단가, 같은 조직 단가, 같은 환산식을 씁니다. 견적 호출 자체는 무료이며, 크레딧을 예약하거나 무언가를 생성·저장하지 않습니다.

생성 엔드포인트에 보낼 본문에 kind 하나만 더해 보내면 됩니다. prompt 는 필요 없습니다.

어떤 생성 요청의 견적인지. image, video, music 중 하나.

생성에 쓸 모델 ID. 생성 엔드포인트와 같은 값입니다.

kind 별로 생성 엔드포인트의 파라미터를 그대로 받습니다.

생략한 파라미터는 생성 요청과 똑같이 모델 기본값으로 계산합니다.

항상 "estimate".

요청한 kind.

견적을 낸 모델 ID.

예상 차감 크레딧(lines 합계, 소수 넷째 자리).

bound 가 "exact" 이면 true.

실제 차감액이 견적과 어떤 관계인지.

견적 항목. 보통 생성 한 줄이고, 조직이 프롬프트 검사(마스킹)를 켜 두었다면 그 요금이 한 줄 더 붙습니다.

비디오 — 정확한 견적:

토큰으로 과금되는 이미지 모델 — 최소값:

길이를 정하지 않은 효과음 — 최대값:

위 숫자는 예시입니다. 실제 금액은 계정과 모델 단가에 따라 다릅니다.

이미지는 견적도 생성 요청과 같은 모델 검사를 거칩니다(number_of_images 최대값 포함). 비디오 견적은 모델 기본 파라미터만 채울 뿐 input_urls나 참조 이미지는 검사하지 않으므로, 견적이 통과한 요청도 생성 단계에서 거절될 수 있습니다.

생성 응답에도 실제로 차감된 크레딧이 실립니다 — 이미지·비디오는 응답의 credits_charged, 음악은 X-Credits-Charged 헤더입니다. 생성 항목이 exact 였다면 이 값과 같습니다. content_filter 항목(조직이 프롬프트를 검사할 때)은 별도 사용 내역으로 차감되므로 credits_charged·X-Credits-Charged에는 포함되지 않습니다.