# 料金

各モデルの料金は、モデルの提供元が米ドルで請求する金額と正確に同じです。料金は **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.ru/v1/models/{model_id}` に表示されます:

| 単位 | 数量 |
|---|---|
| `second` | 出力動画または音声の秒数（`duration`） |
| `image` | 生成された画像の数（`num_images`） |
| `megapixel` | 出力の幅 × 高さ（メガピクセル単位、1 MP = 1024 × 1024 ピクセル） |
| `video` | 生成された動画1本 |
| `request` | 1回の呼び出し |
| `1000_characters` | 入力テキストの文字数（1000文字単位） |
| `step` | 学習ステップ数 |

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

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

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

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

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

モデルのページには「実行あたりの料金」、「入力動画1秒あたりの料金」（および類似の表記）、「実行あたりの推定料金」、または「使用状況に基づく課金」と表示されます。`GET https://api.doitong.ru/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` と表示）。

```json 200 OK · 使用状況に基づくモデルの見積もり
{
  "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` に、保留された金額と使用量に基づく金額が表示されます:

```json
{
  "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.ru/v1/quote/{model_id}` は、`run` に送信するものとまったく同じ本文を受け取り、その入力の料金を返します。使用状況に基づいて [課金されるモデル](#metered) を除き、正確な料金が返されます。この場合は実行にかかり得る最大額です。APIキーは不要で、料金もかかりません:

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

```json 200 OK · 見積もり
{
  "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` を指定します。

> [!TIP]
> **見積もりが請求額です。** 同じ関数で両方を計算するため、この入力での実行料金は正確に `credits` になります。
> ただし、[使用状況に基づいて課金されるモデル](#metered)（`mode: metered`）では例外です。この場合、`credits` は実行にかかり得る最大額で、開始時に引き落とされ、未使用分は実行後に返金されます。

## 料金オブジェクト

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クレジット）。使用状況に基づくリクエストでは、[使用状況に基づく課金](#metered) にあるとおり `mode`、`held`、`typical`、`settled` も追加されます。
- account: `GET https://api.doitong.ru/v1/account` は `credits`（API残高）、`balance: { "credits", "usd" }`、`storage`（ファイルストレージの料金、使用状況、月間見積もり）を返します。

## 返金

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

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

## ファイルストレージ

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

| | 保存期間 | 料金 |
|---|---|---|
| 永久（`permanent`、デフォルト） | 削除するまで | 1 GB・1か月あたり 100 APIクレジット（$0.10） |
| 7日間（`temporary`） | 7日間 | 無料 |

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

## 現在の料金

| モデル | ID | 価格 | 開始価格 |
|---|---|---|---|
| [FLUX.1 \[dev\]](https://doitong.com/developers/models/flux/dev) | `flux/dev` | 1メガピクセルあたり$0.025 | $0.025 (25 APIクレジット) |
| [FLUX.1 \[schnell\]](https://doitong.com/developers/models/flux/schnell) | `flux/schnell` | 1メガピクセルあたり$0.003 | $0.003 (3 APIクレジット) |
| [FLUX.2 \[dev\]](https://doitong.com/developers/models/flux-2) | `flux-2` | 1メガピクセルあたり$0.012 | $0.012 (12 APIクレジット) |
| [FLUX.2 \[pro\]](https://doitong.com/developers/models/flux-2-pro) | `flux-2-pro` | 出力画像の1メガピクセルあたり$0.015 | $0.015 (15 APIクレジット) |
| [GPT Image 2.5 Text to Image](https://doitong.com/developers/models/openai/gpt-image-2.5/flare/text-to-image) | `openai/gpt-image-2.5/flare/text-to-image` | 1画像あたり$0.008から | $0.008 (8 APIクレジット) |
| [Ideogram V4.5](https://doitong.com/developers/models/ideogram/v4.5) | `ideogram/v4.5` | 1画像あたり$0.03から | $0.03 (30 APIクレジット) |
| [Nano Banana 2](https://doitong.com/developers/models/nano-banana-2) | `nano-banana-2` | 1画像あたり$0.06から | $0.06 (60 APIクレジット) |
| [Nano Banana Pro](https://doitong.com/developers/models/nano-banana-pro) | `nano-banana-pro` | 1画像あたり$0.15から | $0.15 (150 APIクレジット) |
| [Qwen Image 3 Text to Image](https://doitong.com/developers/models/alibaba/qwen-image-3/text-to-image) | `alibaba/qwen-image-3/text-to-image` | 1画像あたり$0.04から | $0.04 (40 APIクレジット) |
| [Recraft V4.1 Text to Image](https://doitong.com/developers/models/recraft/v4.1/text-to-image) | `recraft/v4.1/text-to-image` | 1画像あたり$0.035 | $0.035 (35 APIクレジット) |
| [Seedream 5.0 Pro Text to Image](https://doitong.com/developers/models/bytedance/seedream/v5/pro/text-to-image) | `bytedance/seedream/v5/pro/text-to-image` | $0.068から | $0.068 (68 APIクレジット) |
| [FLUX.1 Kontext \[pro\]](https://doitong.com/developers/models/flux-pro/kontext) | `flux-pro/kontext` | 1画像あたり$0.04 | $0.04 (40 APIクレジット) |
| [Nano Banana 2 Edit](https://doitong.com/developers/models/nano-banana-2/edit) | `nano-banana-2/edit` | 1画像あたり$0.06から | $0.06 (60 APIクレジット) |
| [Nano Banana Pro Edit](https://doitong.com/developers/models/nano-banana-pro/edit) | `nano-banana-pro/edit` | 1画像あたり$0.15から | $0.15 (150 APIクレジット) |
| [Qwen Image 3 Edit](https://doitong.com/developers/models/alibaba/qwen-image-3/edit) | `alibaba/qwen-image-3/edit` | 1画像あたり$0.04から | $0.04 (40 APIクレジット) |
| [FLUX 3 Max Text to Video](https://doitong.com/developers/models/blackforestlabs/flux-3-max/text-to-video) | `blackforestlabs/flux-3-max/text-to-video` | 出力動画の1秒あたり$0.0425から | $0.043 (43 APIクレジット) |
| [Grok Imagine Video 1.5 Text to Video](https://doitong.com/developers/models/xai/grok-imagine-video/v1.5/text-to-video) | `xai/grok-imagine-video/v1.5/text-to-video` | 1秒あたり$0.08から | $0.48 (480 APIクレジット) |
| [Kling 3.0 Pro Text to Video](https://doitong.com/developers/models/kling-video/v3/pro/text-to-video) | `kling-video/v3/pro/text-to-video` | 1秒あたり$0.112から | $0.56 (560 APIクレジット) |
| [LTX 2.5 Pro Text to Video](https://doitong.com/developers/models/lightricks/ltx-2.5/text-to-video/pro) | `lightricks/ltx-2.5/text-to-video/pro` | 1秒あたり$0.12から | $0.72 (720 APIクレジット) |
| [MiniMax H3 Text to Video](https://doitong.com/developers/models/minimax/h3/text-to-video) | `minimax/h3/text-to-video` | 1秒あたり$0.05から | $0.25 (250 APIクレジット) |
| [Seedance 2.0 Fast Text to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/text-to-video) | `bytedance/seedance-2.0/fast/text-to-video` | 1秒あたり$0.113から | $0.452 (452 APIクレジット) |
| [Seedance 2.0 Text to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/text-to-video) | `bytedance/seedance-2.0/text-to-video` | 1秒あたり$0.141から | $0.564 (564 APIクレジット) |
| [Veo 3.1](https://doitong.com/developers/models/veo3.1) | `veo3.1` | 1秒あたり$0.20から | $1.60 (1,600 APIクレジット) |
| [Veo 3.1 Fast](https://doitong.com/developers/models/veo3.1/fast) | `veo3.1/fast` | 1秒あたり$0.10から | $0.80 (800 APIクレジット) |
| [Wan 3.0 Text to Video](https://doitong.com/developers/models/alibaba/wan-3.0/text-to-video) | `alibaba/wan-3.0/text-to-video` | 1秒あたり$0.05から | $0.25 (250 APIクレジット) |
| [FLUX 3 Max Image to Video](https://doitong.com/developers/models/blackforestlabs/flux-3-max/image-to-video) | `blackforestlabs/flux-3-max/image-to-video` | 出力動画の1秒あたり$0.0425から | $0.043 (43 APIクレジット) |
| [Grok Imagine Video 1.5 Image to Video](https://doitong.com/developers/models/xai/grok-imagine-video/v1.5/image-to-video) | `xai/grok-imagine-video/v1.5/image-to-video` | 1秒あたり$0.082から | $0.492 (492 APIクレジット) |
| [Kling 3.0 Pro Image to Video](https://doitong.com/developers/models/kling-video/v3/pro/image-to-video) | `kling-video/v3/pro/image-to-video` | 1秒あたり$0.112から | $0.56 (560 APIクレジット) |
| [LTX 2.5 Pro Image to Video](https://doitong.com/developers/models/lightricks/ltx-2.5/image-to-video/pro) | `lightricks/ltx-2.5/image-to-video/pro` | 1秒あたり$0.12から | $0.72 (720 APIクレジット) |
| [MiniMax H3 Image to Video](https://doitong.com/developers/models/minimax/h3/image-to-video) | `minimax/h3/image-to-video` | 1秒あたり$0.05から | $0.25 (250 APIクレジット) |
| [Seedance 2.0 Fast Image to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/image-to-video) | `bytedance/seedance-2.0/fast/image-to-video` | 1秒あたり$0.113から | $0.452 (452 APIクレジット) |
| [Seedance 2.0 Image to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/image-to-video) | `bytedance/seedance-2.0/image-to-video` | 1秒あたり$0.141から | $0.564 (564 APIクレジット) |
| [Veo 3.1 Fast Image to Video](https://doitong.com/developers/models/veo3.1/fast/image-to-video) | `veo3.1/fast/image-to-video` | 1秒あたり$0.10から | $0.80 (800 APIクレジット) |
| [Veo 3.1 Image to Video](https://doitong.com/developers/models/veo3.1/image-to-video) | `veo3.1/image-to-video` | 1秒あたり$0.20から | $1.60 (1,600 APIクレジット) |
| [Wan 3.0 Image to Video](https://doitong.com/developers/models/alibaba/wan-3.0/image-to-video) | `alibaba/wan-3.0/image-to-video` | 1秒あたり$0.05から | $0.25 (250 APIクレジット) |
| [Seedance 2.0 Fast Reference to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/reference-to-video) | `bytedance/seedance-2.0/fast/reference-to-video` | 1秒あたり$0.113から | $0.452 (452 APIクレジット) |
| [Seedance 2.0 Reference to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/reference-to-video) | `bytedance/seedance-2.0/reference-to-video` | 1秒あたり$0.141から | $0.564 (564 APIクレジット) |
| [Kling AI Avatar 2.0 Pro](https://doitong.com/developers/models/kling-video/ai-avatar/v2/pro) | `kling-video/ai-avatar/v2/pro` | 入力音声の1秒あたり$0.115 | $0.115 (115 APIクレジット) |
| [Sync Lipsync 3](https://doitong.com/developers/models/sync-lipsync/v3) | `sync-lipsync/v3` | 出力動画の1分あたり$8.00 | $8.00 (8,000 APIクレジット) |
| [VEED Fabric 1.0](https://doitong.com/developers/models/veed/fabric-1.0) | `veed/fabric-1.0` | 入力音声の1秒あたり$0.08から | $0.08 (80 APIクレジット) |
| [Topaz Image Upscale](https://doitong.com/developers/models/topaz/upscale/image/precision) | `topaz/upscale/image/precision` | 出力画像の24メガピクセルあたり$0.08 | $0.08 (80 APIクレジット) |
| [Topaz Video Upscale](https://doitong.com/developers/models/topaz/upscale/video/precision) | `topaz/upscale/video/precision` | 入力動画の1秒あたり$0.00667から | $0.10 (100 APIクレジット) |
| [Bria RMBG 2.0](https://doitong.com/developers/models/bria/background/remove) | `bria/background/remove` | $0.018から | $0.018 (18 APIクレジット) |
| [Eleven v4 Text to Speech](https://doitong.com/developers/models/elevenlabs/tts/eleven-v4) | `elevenlabs/tts/eleven-v4` | 1000文字あたり$0.08 | $0.08 (80 APIクレジット) |
| [MiniMax Speech 2.8 HD](https://doitong.com/developers/models/minimax/speech-2.8-hd) | `minimax/speech-2.8-hd` | 1000文字あたり$0.10 | $0.10 (100 APIクレジット) |
| [MiniMax Music 3](https://doitong.com/developers/models/minimax/music-3) | `minimax/music-3` | 1秒あたり$0.002 | $0.12 (120 APIクレジット) |
| [MMAudio V2](https://doitong.com/developers/models/mmaudio-v2) | `mmaudio-v2` | 1秒あたり$0.001 | $0.008 (8 APIクレジット) |

これらは注目のモデルです。1,496個すべてのモデルとその価格は[モデルカタログ](https://doitong.com/developers/models)および`GET /models`（キー不要）で確認できます。

## チャージ

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