料金

各モデルの料金は、モデルの提供元が米ドルで請求する金額と正確に同じです。料金は API残高 から支払われ、 APIクレジット で計算されます: 1,000 APIクレジット = $1。API残高は独立した残高であり、Doitongアプリの クレジットとは別です。プラン、最低利用額、モデルごとの手数料はありません。呼び出しにはその料金がかかり、 リクエストが受け付けられた時点でAPI残高から引き落とされます。

ロシア（doitong.ru、api.doitong.ru、または ?currency=rub）では、料金はルーブルでも表示されます: USD料金 × USD/RUBレート × 1.3。

単位#

各モデルには1つの課金単位があり、モデルのページと GET https://api.doitong.com/v1/models/{model_id} に表示されます:

料金 = 数量 × 単位あたりのAPIクレジット。1 APIクレジット単位（$0.001）に切り上げられ、1未満にはなりません。非常に安価な 単位では、単位あたりの料金が小数になる場合があります（1秒あたり 0.4 APIクレジット）。切り上げられるのは呼び出し全体の料金だけです。

入力に応じて異なる料金を請求するモデルもあります。音声付き動画は音声なしより高く、4Kは1Kより高い、といった具合です。これらの ルール は各モデルのページに記載されています。省略したパラメータはデフォルト値として扱われるため、入力に対して表示される料金が実際の支払額です。

正確な料金、計測料金、推定料金、使用状況に基づく料金#

すべての料金には mode があります:

• exact: 入力（秒数、画像数、メガピクセル数、文字数、ステップ数、または動画1本・呼び出し1回あたりの固定料金）から料金が計算されます。
• measured: 送信したファイルに基づいて料金が決まります。入力動画または音声の長さ、入力画像のサイズ、動画のフレームレートまたはフレーム数などです。アップスケーラー、リップシンク、動画から動画への変換、文字起こし、音声ツールはこの方式で料金が決まります。実行前にAPIがファイルの長さ、解像度、フレームレートを読み取るため（見積もりでも同じ処理を行います）、見積もりは実行時の料金と正確に一致します。モデルのページには支払い対象（「入力動画1秒あたりの料金」など）が記載され、計算ツールにはファイルの数値を入力します。読み取れないファイルは unmeasurable_input で拒否され、料金は発生しません。
• estimate: モデル自体のコストが、入力から事前に判断できない要素（トークン、計算時間など）に左右されます。このようなモデルでは、実際の実行の平均コストに基づいて設定された 実行あたりの推定固定料金 が請求されます（画像数がある場合は出力画像1枚あたり）。実行前に料金は確認できます。見積もりが支払額です。
• metered: モデルは 実際の使用状況に基づいて課金 されます。言語モデルまたはビジョンモデルが読み書きするトークン、音声モデルが生成する音声の秒数、モデルの処理時間など、実行自体でしか分からない使用量です。以下の 使用状況に基づく課金 を参照してください。

モデルのページには「実行あたりの料金」、「入力動画1秒あたりの料金」（および類似の表記）、「実行あたりの推定料金」、または「使用状況に基づく課金」と表示されます。GET https://api.doitong.com/v1/models?mode=measured、?mode=estimate、?mode=metered で一覧を取得できます。

使用状況に基づく課金#

metered モデルには使用状況に基づく料金（「1000トークンあたり$0.01」、「生成音声1秒あたり$0.002」、「処理時間1秒あたり$0.00111」）と 実行あたりの上限額 があります。これは、リクエストの内容（max_tokens、テキストの長さ、解像度、出力数）とモデルが公開している上限から算出される、1回の実行でかかり得る最大額です。URLの背後にあるファイルの内容には左右されません。処理時間または音声セッションの長さに基づいて課金されるモデルでは、上限はリクエストが実行できる最長時間（画像は15分、音声は30分、動画は60分）なので、通常の実行より大幅に高くなる場合があります。上限がモデルの実行あたりの制限を超える入力（非常に長いテキストなど）は、422 invalid_input で拒否されます:

1. 見積もりはその上限を credits として返します（通常の実行を示す hold と typical も含まれます）。実行開始時に上限額がAPI残高から引き落とされ、残高とキーの予算でこの金額を支払える必要があります。
2. 実行が成功すると、リクエストはモデルが報告した使用量に基づいて精算されます: 使用量 × 使用状況に基づく料金を、1 APIクレジット単位に切り上げます。上限額の残額は自動的に返金 され、API残高の refund 行として1回記録されます。
3. 使用量が上限を超える場合でも、実行料金が上限を超えることはありません。失敗またはキャンセルされた実行は、常に全額返金されます。

ほとんどの実行は上限額を大幅に下回ります。モデルのページには、ビルダーの入力に対する「実行あたり最大$X」と、通常の実行に対する料金（カタログでは「from」）が表示されます。処理時間に基づいて課金される一部のモデルでは、使用量はモデルの処理時間です（approximate と表示）。

{
  "object": "quote",
  "credits": 621,
  "usd": "0.621",
  "mode": "metered",
  "label": "Charged by usage",
  "hold": { "credits": 621, "usd": "0.621" },
  "typical": { "credits": 10, "usd": "0.01" },
  "settlement": "usage",
  "display": "$0.01 / 1000 tokens",
  "breakdown": "up to 62.035 × 1000 tokens × $0.01"
}

実行後、リクエストの cost に、保留された金額と使用量に基づく金額が表示されます:

{
  "cost": { "credits": 621, "usd": "0.621", "charged": 621, "refunded": 611, "mode": "metered", "held": 621,
            "typical": 10, "settled": { "status": "settled", "credits": 10, "usd": "0.01", "quantity": 1,
            "unit": "1000_tokens", "unit_usd": "0.01", "source": "billed_usage", "approximate": false } }
}

charged − refunded が実行にかかった料金です。settled.status は、結果が返ってから精算されるまでの間は pending です。モデルが使用量をまったく報告しなかったまれなケースでは no_usage となり、その場合は上限額が料金として確定します。

実行前の見積もり#

POST https://api.doitong.com/v1/quote/{model_id} は、run に送信するものとまったく同じ本文を受け取り、その入力の料金を返します。使用状況に基づいて 課金されるモデル を除き、正確な料金が返されます。この場合は実行にかかり得る最大額です。APIキーは不要で、料金もかかりません:

curl -X POST "https://api.doitong.com/v1/quote/flux/schnell" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A lighthouse at dusk", "num_images": 2}'

{
  "object": "quote",
  "model": "flux/schnell",
  "credits": 6,
  "usd": "0.006",
  "unit": "megapixel",
  "quantity": 2,
  "unit_credits": 3,
  "mode": "exact",
  "label": "Price per run",
  "display": "$0.003 / megapixel",
  "breakdown": "2 MP (2 images) × 3 API credits",
  "input": { "prompt": "A lighthouse at dusk", "num_images": 2 },
  "warnings": []
}

キーを指定すると、見積もりには balance_credits と balance_usd（API残高）、affordable、key_budget_remaining も含まれます。rub 額を追加するには ?currency=rub を指定します。

料金オブジェクト#

APIのすべての料金は同じ形式です:

• models: price: { "credits": 112, "usd": "0.112", "unit": "second", "display": "$0.112 / second", "credits_display": "112 API credits / second", "from_credits": 560, "from_usd": "0.56", "mode": "exact" } — ロシアまたは ?currency=rub 指定時は rub、rub_display、from_rub も含まれます。
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 }（APIクレジット）。使用状況に基づくリクエストでは、使用状況に基づく課金 にあるとおり mode、held、typical、settled も追加されます。
• account: GET https://api.doitong.com/v1/account は credits（API残高）、balance: { "credits", "usd" }、storage（ファイルストレージの料金、使用状況、月間見積もり）を返します。

返金#

• 無効なリクエスト（実行開始前の 4xx）には料金が発生しません。
• failed（timeout を含む）で終了したリクエストは、API残高に自動的に全額返金されます。
• 開始前にキャンセルしたリクエストは全額返金されます。モデルが生成中になった後のキャンセルはリクエストにすぎません。モデルが完了すると、結果が配信され、料金が発生します。
• 成功した metered リクエストでは、上限額のうち未使用の部分が返金されます。

リクエストオブジェクトにはすべて記録されます: cost.credits、cost.charged、cost.refunded。

ファイルストレージ#

出力ファイルはストレージに保存されます。アカウントまたは実行ごとに（?storage=）選択できます:

永久ストレージの料金は、API残高から1日1回請求されます: 保存容量（GB）×月額料金 ÷ その月の日数。台帳には種類 storage の行として記録されます。APIクレジットの端数は翌日に繰り越されるため、1か月の合計は正確に GB × 100 APIクレジットになります（1 GB = 1024³バイト、10 GBを1か月保存すると 1,000 APIクレジット）。残高が0未満になることはありません。支払えない場合、その日の料金は請求されず、メールが送信されます。保存ファイルが一時ファイルに変更される前に、30日間チャージする猶予があります。その後、7日で削除されます。詳細: ファイル。

現在の料金#

これらは注目のモデルです。1,496個すべてのモデルとその価格はモデルカタログおよびGET /models（キー不要）で確認できます。

チャージ#

https://doitong.com/developers/dashboard#balance でAPI残高に入金します。残高が不足している場合、実行は 402 insufficient_credits と top_up_url を返します。各APIキーには、APIクレジット単位で独自の予算上限を設定することもできます（認証を参照）。