実際の費用とタスク使用量
生成タスクの 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 は確定した純請求額がゼロであることを示します. 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}も利用可) - Task 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 | 動画モデルが報告した非負整数のトークン内訳. 取得できたフィールドのみ返され, 確認済みのトークン課金の確定処理で total_tokens が補完される場合があります |
tool_usage | object | web_search, image_search, grounding_queries などのツール使用回数. 取得できた項目を返し, トークン内訳とは独立しています |
課金数量はタスクに保存された課金記録に基づきます. 固定料金は作成時に確定した数量, 後払い確定は最終確定数量を使い, 現在の価格や金額からの逆算はしません. per_request は requests, per_second は output_seconds, per_token は billed_tokens を使います.
入力動画時間や入力画像などの追加課金項目はある場合のみ返し, ゼロのときは省略します.
金額のみ保存され検証可能な課金数量がない過去のタスクでは, 確認できないフィールドを省略し, 未提供のトークン内訳をゼロで補完しません. トークン課金の確定後, 動画トークン内訳は報告合計が最終課金数量と一致する場合のみ保持します. usage と billing の有無は独立しています: usage がなくても未課金とは限らず結果の返却も妨げません.
一方で charge_type などの課金数量が返る場合は, 必ず billing.status=settled と実際の金額が伴います. 送信時に一括控除される固定料金タスクも settled を返します. タスク照会と Webhook は同じ確認条件とフィールド値を使います.