# Harga

Setiap model berharga tepat seperti yang dikenakan oleh pembuatnya, dalam dolar AS. Anda membayar daripada **baki API**,
yang dikira dalam **kredit API**: **1,000 kredit API = $1**. Baki API ialah baki tersendiri, berasingan daripada kredit aplikasi Doitong. Tiada pelan, minimum atau fi setiap model: panggilan berharga mengikut harganya dan ditolak daripada baki API apabila permintaan diterima.

Di Rusia (doitong.ru, api.doitong.ru atau `?currency=rub`), harga turut dipaparkan dalam rubel: harga USD × kadar USD/RUB × 1.3.

## Unit

Setiap model mempunyai satu unit pengebilan, dipaparkan pada halamannya dan dalam `GET https://api.doitong.com/v1/models/{model_id}`:

| Unit | Kuantiti |
|---|---|
| `second` | Saat video atau audio output (`duration`) |
| `image` | Imej yang dijana (`num_images`) |
| `megapixel` | Lebar × tinggi output, dalam megapiksel (1 MP = 1024 × 1024 piksel) |
| `video` | Satu video yang dijana |
| `request` | Satu panggilan |
| `1000_characters` | Aksara teks input, bagi setiap 1000 |
| `step` | Langkah latihan |

Harga = kuantiti × kredit API setiap unit, dibundarkan ke atas kepada kredit API penuh ($0.001), dan tidak pernah kurang daripada 1. Unit yang sangat murah boleh mempunyai harga pecahan setiap unit (`0.4` kredit API sesaat); hanya jumlah panggilan dibundarkan.

Sesetengah model mengenakan kadar berbeza bergantung pada input: video dengan bunyi lebih mahal daripada tanpa bunyi, 4K lebih mahal daripada 1K dan sebagainya. **Peraturan** ini disenaraikan pada setiap halaman model. Parameter yang anda tinggalkan menggunakan nilai lalainya, jadi harga yang anda lihat untuk sesuatu input ialah harga yang anda bayar.

## Harga tepat, diukur, anggaran dan berdasarkan penggunaan

Setiap harga mempunyai `mode`:

- `exact`: harga dikira daripada input anda (saat, imej, megapiksel, aksara, langkah, atau satu harga rata bagi setiap video atau panggilan).
- `measured`: harga mengikut fail yang anda hantar: panjang video atau audio input, saiz imej input, kadar bingkai atau bilangan bingkai video. Penskala naik, penyegerakan bibir, video-ke-video, transkripsi dan alat audio berharga dengan cara ini. Sebelum dijalankan, API membaca panjang, resolusi dan kadar bingkai fail (sebut harga melakukan perkara yang sama), jadi sebut harga tepat seperti caj larian. Halaman model menyatakan perkara yang anda bayar ("Harga sesaat video input anda") dan kalkulatornya menggunakan nombor fail anda. Fail yang tidak boleh dibaca ditolak dengan `unmeasurable_input` dan tiada caj dikenakan.
- `estimate`: kos model sendiri bergantung pada sesuatu yang tidak dapat diketahui input terlebih dahulu (token, masa pengiraan). Model sedemikian mengenakan **harga anggaran tetap setiap larian** (setiap imej output apabila mempunyai bilangan imej), yang ditetapkan berdasarkan kos purata larian sebenar model itu. Anda tetap mengetahui harga sebelum menjalankannya: sebut harga ialah jumlah yang anda bayar.
- `metered`: model **dicaj berdasarkan penggunaan sebenar**, yang hanya diketahui oleh larian itu sendiri: token yang dibaca dan ditulis oleh model bahasa atau penglihatan, saat pertuturan yang dijana model suara atau masa pemprosesan model. Lihat [Dicaj berdasarkan penggunaan](#metered) di bawah.

Halaman model menyatakan "Harga setiap larian", "Harga sesaat video input anda" (dan yang serupa), "Harga anggaran setiap larian" atau "Dicaj berdasarkan penggunaan"; `GET https://api.doitong.com/v1/models?mode=measured`, `?mode=estimate` dan `?mode=metered` menyenaraikannya.

## Dicaj berdasarkan penggunaan

Model `metered` mempunyai harga penggunaan ("$0.01 bagi setiap 1000 token", "$0.002 sesaat audio yang dijana", "$0.00111 sesaat masa pemprosesan") dan **maksimum setiap larian**: jumlah tertinggi yang boleh dicaj, berdasarkan perkara yang dinyatakan oleh permintaan anda (`max_tokens`, panjang teks, resolusi, bilangan output) dan had model yang diterbitkan. Ia tidak pernah bergantung pada kandungan fail di sebalik URL. Bagi model yang dibilkan mengikut masa pemprosesan atau panjang sesi suara, maksimum ialah tempoh paling lama permintaan boleh berjalan (15 minit untuk imej, 30 untuk audio, 60 untuk video), jadi jauh melebihi larian biasa. Input yang maksimum cajnya melebihi had setiap larian model (teks yang sangat panjang) ditolak dengan `422 invalid_input`:

1. Sebut harga mengembalikan maksimum itu sebagai `credits` (dengan `hold` dan `typical`, iaitu larian biasa). Apabila larian bermula, maksimum ditolak daripada baki API dan baki serta belanjawan kunci anda mesti dapat menampungnya.
2. Apabila larian berjaya, permintaan diselesaikan mengikut penggunaan yang dilaporkan model: penggunaan × harga penggunaan, dibundarkan ke atas kepada kredit API penuh. **Baki maksimum yang tidak digunakan dibayar balik secara automatik**, sekali, sebagai baris `refund` bagi baki API.
3. Sesuatu larian tidak pernah berharga lebih daripada maksimumnya, walaupun penggunaannya sepatutnya melebihi jumlah itu. Larian yang gagal atau dibatalkan dibayar balik sepenuhnya, seperti biasa.

Kebanyakan larian berharga jauh lebih rendah daripada maksimum; halaman model menunjukkan "Sehingga $X setiap larian" untuk input pembina dan larian biasa ("daripada" dalam katalog). Bagi beberapa model yang dibilkan mengikut masa pemprosesan, penggunaan ialah masa pemprosesan model (ditandakan `approximate`).

```json 200 OK · sebut harga model metered
{
  "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"
}
```

Selepas larian, `cost` permintaan menunjukkan jumlah yang ditahan dan jumlah penggunaan:

```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` ialah kos larian. `settled.status` ialah `pending` untuk tempoh antara keputusan dan penyelesaian, dan `no_usage` dalam keadaan jarang berlaku apabila model tidak melaporkan sebarang penggunaan (maka maksimum kekal sebagai harga).

## Dapatkan sebut harga sebelum menjalankan

`POST https://api.doitong.com/v1/quote/{model_id}` menerima isi kandungan yang sama seperti yang akan anda hantar kepada `run` dan mengembalikan harga input itu: harga tepat, kecuali bagi model [yang dicaj berdasarkan penggunaan](#metered), yang mengembalikan jumlah maksimum yang boleh dikenakan. Ia tidak memerlukan kunci dan tidak berharga apa-apa:

```bash
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}'
```

```json 200 OK · sebut harga
{
  "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": []
}
```

Dengan kunci, sebut harga turut mengembalikan `balance_credits` dan `balance_usd` (baki API anda), `affordable` dan `key_budget_remaining`. Tambah `?currency=rub` untuk jumlah `rub`.

> [!TIP]
> **Sebut harga ialah caj.** Fungsi yang sama mengira kedua-duanya, jadi larian dengan input ini berharga tepat `credits`.
> Satu-satunya pengecualian ialah model [Dicaj berdasarkan penggunaan](#metered) (`mode: metered`): `credits` ialah jumlah maksimum yang boleh dikenakan, ditolak apabila larian bermula, dan bahagian yang tidak digunakan dibayar balik selepas larian.

## Objek harga

Setiap harga dalam API mempunyai bentuk yang sama:

- 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" }` — serta `rub`, `rub_display` dan `from_rub` di Rusia atau dengan `?currency=rub`;
- requests: `cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 }` (kredit API; permintaan metered menambah `mode`, `held`, `typical` dan `settled`, lihat [Dicaj berdasarkan penggunaan](#metered));
- account: `GET https://api.doitong.com/v1/account` mengembalikan `credits` (baki API), `balance: { "credits", "usd" }` dan `storage` (harga storan fail, penggunaan dan anggaran bulanan).

## Bayaran balik

- Permintaan tidak sah (mana-mana `4xx` sebelum larian bermula) tidak pernah dicaj.
- Permintaan yang berakhir `failed` (termasuk `timeout`) dibayar balik sepenuhnya ke baki API secara automatik.
- Permintaan yang anda batalkan sebelum bermula dibayar balik sepenuhnya. Setelah model menjana output, pembatalan hanyalah permintaan: jika model selesai, keputusan dihantar dan dicaj.
- Permintaan `metered` yang berjaya mendapat kembali bahagian maksimumnya yang tidak digunakan.

Objek permintaan menunjukkan semuanya: `cost.credits`, `cost.charged` dan `cost.refunded`.

## Storan fail

Fail output disimpan pada storan kami. Anda memilihnya dalam akaun atau bagi setiap larian (`?storage=`):

| | Disimpan | Harga |
|---|---|---|
| Selama-lamanya (`permanent`, lalai) | Sehingga anda memadamkannya | 100 kredit API ($0.10) setiap GB sebulan |
| 7 hari (`temporary`) | 7 hari | Percuma |

Storan kekal dicaj sekali sehari daripada baki API: GB yang disimpan × harga bulanan ÷ bilangan hari dalam bulan, sebagai baris lejar berjenis `storage`. Pecahan kredit API dibawa ke hari berikutnya, jadi jumlah sebulan tepat- tepat GB × 100 kredit API (1 GB = 1024³ bait; 10 GB yang disimpan selama sebulan berharga 1,000 kredit API). Baki tidak pernah menjadi negatif: apabila baki tidak dapat membayar, caj untuk hari itu tidak dikenakan, anda menerima e-mel dan mempunyai 30 hari untuk tambah nilai sebelum fail yang disimpan menjadi sementara dan dipadam 7 hari kemudian. Butiran: [Fail](https://doitong.com/developers/docs/files#storage).

## Harga semasa

| Model | ID | Harga | Daripada |
|---|---|---|---|
| [FLUX.1 \[dev\]](https://doitong.com/developers/models/flux/dev) | `flux/dev` | $0.025 / megapiksel | $0.025 (25 kredit API) |
| [FLUX.1 \[schnell\]](https://doitong.com/developers/models/flux/schnell) | `flux/schnell` | $0.003 / megapiksel | $0.003 (3 kredit API) |
| [FLUX.2 \[dev\]](https://doitong.com/developers/models/flux-2) | `flux-2` | $0.012 / megapiksel | $0.012 (12 kredit API) |
| [FLUX.2 \[pro\]](https://doitong.com/developers/models/flux-2-pro) | `flux-2-pro` | $0.015 / megapiksel imej output | $0.015 (15 kredit 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` | daripada $0.008 / imej | $0.008 (8 kredit API) |
| [Ideogram V4.5](https://doitong.com/developers/models/ideogram/v4.5) | `ideogram/v4.5` | daripada $0.03 / imej | $0.03 (30 kredit API) |
| [Nano Banana 2](https://doitong.com/developers/models/nano-banana-2) | `nano-banana-2` | daripada $0.06 / imej | $0.06 (60 kredit API) |
| [Nano Banana Pro](https://doitong.com/developers/models/nano-banana-pro) | `nano-banana-pro` | daripada $0.15 / imej | $0.15 (150 kredit 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` | daripada $0.04 / imej | $0.04 (40 kredit API) |
| [Recraft V4.1 Text to Image](https://doitong.com/developers/models/recraft/v4.1/text-to-image) | `recraft/v4.1/text-to-image` | $0.035 / imej | $0.035 (35 kredit 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` | daripada $0.068 | $0.068 (68 kredit API) |
| [FLUX.1 Kontext \[pro\]](https://doitong.com/developers/models/flux-pro/kontext) | `flux-pro/kontext` | $0.04 / imej | $0.04 (40 kredit API) |
| [Nano Banana 2 Edit](https://doitong.com/developers/models/nano-banana-2/edit) | `nano-banana-2/edit` | daripada $0.06 / imej | $0.06 (60 kredit API) |
| [Nano Banana Pro Edit](https://doitong.com/developers/models/nano-banana-pro/edit) | `nano-banana-pro/edit` | daripada $0.15 / imej | $0.15 (150 kredit API) |
| [Qwen Image 3 Edit](https://doitong.com/developers/models/alibaba/qwen-image-3/edit) | `alibaba/qwen-image-3/edit` | daripada $0.04 / imej | $0.04 (40 kredit 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` | daripada $0.0425 / saat video output | $0.043 (43 kredit 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` | daripada $0.08 / saat | $0.48 (480 kredit 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` | daripada $0.112 / saat | $0.56 (560 kredit 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` | daripada $0.12 / saat | $0.72 (720 kredit API) |
| [MiniMax H3 Text to Video](https://doitong.com/developers/models/minimax/h3/text-to-video) | `minimax/h3/text-to-video` | daripada $0.05 / saat | $0.25 (250 kredit 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` | daripada $0.113 / saat | $0.452 (452 kredit 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` | daripada $0.141 / saat | $0.564 (564 kredit API) |
| [Veo 3.1](https://doitong.com/developers/models/veo3.1) | `veo3.1` | daripada $0.20 / saat | $1.60 (1,600 kredit API) |
| [Veo 3.1 Fast](https://doitong.com/developers/models/veo3.1/fast) | `veo3.1/fast` | daripada $0.10 / saat | $0.80 (800 kredit 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` | daripada $0.05 / saat | $0.25 (250 kredit 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` | daripada $0.0425 / saat video output | $0.043 (43 kredit 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` | daripada $0.082 / saat | $0.492 (492 kredit 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` | daripada $0.112 / saat | $0.56 (560 kredit 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` | daripada $0.12 / saat | $0.72 (720 kredit API) |
| [MiniMax H3 Image to Video](https://doitong.com/developers/models/minimax/h3/image-to-video) | `minimax/h3/image-to-video` | daripada $0.05 / saat | $0.25 (250 kredit 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` | daripada $0.113 / saat | $0.452 (452 kredit 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` | daripada $0.141 / saat | $0.564 (564 kredit 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` | daripada $0.10 / saat | $0.80 (800 kredit API) |
| [Veo 3.1 Image to Video](https://doitong.com/developers/models/veo3.1/image-to-video) | `veo3.1/image-to-video` | daripada $0.20 / saat | $1.60 (1,600 kredit 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` | daripada $0.05 / saat | $0.25 (250 kredit 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` | daripada $0.113 / saat | $0.452 (452 kredit 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` | daripada $0.141 / saat | $0.564 (564 kredit API) |
| [Kling AI Avatar 2.0 Pro](https://doitong.com/developers/models/kling-video/ai-avatar/v2/pro) | `kling-video/ai-avatar/v2/pro` | $0.115 / saat audio input | $0.115 (115 kredit API) |
| [Sync Lipsync 3](https://doitong.com/developers/models/sync-lipsync/v3) | `sync-lipsync/v3` | $8.00 / minit video output | $8.00 (8,000 kredit API) |
| [VEED Fabric 1.0](https://doitong.com/developers/models/veed/fabric-1.0) | `veed/fabric-1.0` | daripada $0.08 / saat audio input | $0.08 (80 kredit API) |
| [Topaz Image Upscale](https://doitong.com/developers/models/topaz/upscale/image/precision) | `topaz/upscale/image/precision` | $0.08 / 24 megapiksel imej output | $0.08 (80 kredit API) |
| [Topaz Video Upscale](https://doitong.com/developers/models/topaz/upscale/video/precision) | `topaz/upscale/video/precision` | daripada $0.00667 / saat video input | $0.10 (100 kredit API) |
| [Bria RMBG 2.0](https://doitong.com/developers/models/bria/background/remove) | `bria/background/remove` | daripada $0.018 | $0.018 (18 kredit API) |
| [Eleven v4 Text to Speech](https://doitong.com/developers/models/elevenlabs/tts/eleven-v4) | `elevenlabs/tts/eleven-v4` | $0.08 / 1000 aksara | $0.08 (80 kredit API) |
| [MiniMax Speech 2.8 HD](https://doitong.com/developers/models/minimax/speech-2.8-hd) | `minimax/speech-2.8-hd` | $0.10 / 1000 aksara | $0.10 (100 kredit API) |
| [MiniMax Music 3](https://doitong.com/developers/models/minimax/music-3) | `minimax/music-3` | $0.002 / saat | $0.12 (120 kredit API) |
| [MMAudio V2](https://doitong.com/developers/models/mmaudio-v2) | `mmaudio-v2` | $0.001 / saat | $0.008 (8 kredit API) |

Ini ialah model pilihan. Semua 1,496 model dan harganya tersedia dalam [katalog model](https://doitong.com/developers/models) dan dalam `GET /models` (tidak memerlukan kunci).

## Tambah nilai

Tambah wang ke baki API di [https://doitong.com/developers/dashboard#balance](https://doitong.com/developers/dashboard#balance). Apabila baki terlalu rendah, larian menjawab `402 insufficient_credits` dengan `top_up_url`. Setiap kunci API juga boleh dihadkan dengan belanjawannya sendiri dalam kredit API (lihat [Pengesahan](https://doitong.com/developers/docs/authentication#credit-budgets)).