실제 비용 및 작업 사용량
생성 작업의 billing 및 usage 필드의 실제 비용 기준
요금 카탈로그는 현재 요율을 나타내고 실제 과금은 생성 응답, 작업 조회, Webhook, 사용량 레코드로 확정됩니다.
모델 요금과 계정 사용량은 서로 다른 기준의 데이터이므로 현재 가격으로 과거 과금을 역산하지 마세요.
실제 청구 금액
청구 금액을 확인할 수 있으면 생성 응답에 다음 객체가 포함됩니다.
{
"billing": {
"status": "settled",
"credits": "100",
"cost_usd": "0.5"
}
}| 필드 | 의미 |
|---|---|
status | pending, settled, refunded 중 하나 |
credits | 확정된 ToAPIs Credits 사용량이며 10진수 문자열로 반환 |
cost_usd | 같은 확정 청구의 USD 금액이며 10진수 문자열로 반환 |
pending은 최종 금액이 아직 확정되지 않았음을 뜻하며 금액 필드는 생략됩니다. refunded는 확정된 순 청구 금액이 0임을 뜻합니다. billing 객체 전체가 없으면 안전하게 공개할 값을 확인하지 못한 것이며 무료라는 뜻이 아닙니다.
이 객체는 다음 위치에 포함될 수 있습니다.
- 이미지 및 동영상 통합 작업 조회
GET /v1/tasks/{task_id} - 비동기 이미지 작업 조회
GET /v1/images/generations/{task_id} - 비동기 동영상 작업 조회
GET /v1/videos/generations/{task_id}(GET /v1/video/generations/{task_id}및GET /v1/videos/{task_id}도 호환) - 작업 Webhook의
data.billing - 지원되는 비스트리밍 동기 이미지 생성 또는 편집 응답의 최상위
billing
비동기 작업은 완료 후 작업 조회를 최종 청구 금액의 대체 경로로 사용하세요. 스트리밍 이미지 응답, 지원되지 않는 공급자 응답 형식, Playground 요청, 지연 일괄 청구에서는 생략될 수 있습니다.
작업 사용량 필드
이미지와 동영상 작업 조회는 확인된 과금 수량을 최상위 usage에 반환합니다. 성공 Webhook의 data.usage도 같은 정의를 사용합니다. 과금 수량, 모델이 보고한 토큰 내역, 도구 사용 횟수는 각각 확인 가능한 경우 함께 반환됩니다.
| 필드 | 타입 | 설명 |
|---|---|---|
charge_type | string | 과금 방식: per_request, per_second, per_token |
requests | integer | 실제 과금 요청 횟수. 일반 이미지 요청의 n을 이 횟수에 직접 곱하지 않습니다. Midjourney 동영상의 유효한 batch_size는 과금 횟수에 반영됩니다 |
billed_tokens | integer | 가격 계산에 사용한 토큰 수. 일부 이미지 처리 경로는 설정된 선차감 토큰 기준을 사용하므로 실제 생성 토큰 수와 다를 수 있습니다 |
output_seconds | integer | 과금 대상 출력 동영상 길이, 정수 초 단위 |
input_seconds | integer | 과금 대상 입력 동영상 길이, 정수 초 단위 |
input_images | integer | 무료 허용량을 제외한 과금 대상 입력 이미지 수 |
input_tokens, output_tokens, prompt_tokens, completion_tokens, total_tokens | integer | 동영상 모델이 보고한 0 이상의 정수 토큰 내역. 공급자가 제공한 필드만 반환하며, 확정된 토큰 과금 정산으로 total_tokens를 채울 수 있습니다 |
tool_usage | object | web_search, image_search, grounding_queries 등의 도구 사용 횟수. 확인 가능한 필드만 반환하며 토큰 내역과 독립적입니다 |
과금 수량은 작업에 저장된 과금 기록에서 나옵니다: 고정 요금은 생성 시 확인된 수량, 후불 정산은 최종 정산 수량을 사용하고 현재 가격이나 금액으로 역산하지 않습니다. per_request는 requests, per_second는 output_seconds, per_token은 billed_tokens를 사용합니다.
입력 동영상 시간이나 입력 이미지 같은 추가 과금 항목은 있을 때만 반환하고 0이면 생략합니다.
금액만 저장되고 검증 가능한 과금 수량이 없는 과거 작업은 확인할 수 없는 필드를 생략하고 제공되지 않은 토큰 내역을 0으로 채우지 않습니다. 토큰 과금 정산 후 동영상 토큰 내역은 보고된 합계가 최종 과금 수량과 같을 때만 유지됩니다.
usage와 billing의 존재 여부는 서로 독립적입니다: usage가 없다고 미과금은 아니고 결과 반환도 막지 않습니다. 반대로 charge_type 같은 과금 수량이 반환되면 반드시 billing.status=settled와 실제 금액이 함께 옵니다.
제출 시 한 번에 차감되는 고정 요금 작업도 settled를 반환합니다. 작업 조회와 Webhook은 같은 확인 조건과 필드 값을 사용합니다.