Harga

Setiap model memiliki biaya persis seperti yang ditetapkan pembuatnya, dalam dolar AS. Anda membayar dari saldo API, yang dihitung dalam kredit API: 1.000 kredit API = $1. Saldo API berdiri sendiri, terpisah dari kredit aplikasi Doitong. Tidak ada paket, minimum, atau biaya per model: panggilan dikenai harganya, yang dipotong dari saldo API saat permintaan diterima.

Di Rusia (doitong.ru, api.doitong.ru, atau ?currency=rub) harga juga ditampilkan dalam rubel: harga USD × kurs USD/RUB × 1,3.

Satuan#

Setiap model memiliki satu satuan penagihan, yang ditampilkan di halamannya dan di GET https://api.doitong.com/v1/models/{model_id}:

Harga = jumlah × kredit API per satuan, dibulatkan ke atas menjadi kredit API bulat ($0,001), dan tidak pernah kurang dari 1. Satuan yang sangat murah dapat memiliki harga pecahan per satuan (0.4 kredit API per detik); hanya total panggilan yang dibulatkan.

Beberapa model mengenakan tarif berbeda bergantung pada input: video dengan suara lebih mahal daripada tanpa suara, 4K lebih mahal daripada 1K, dan seterusnya. Aturan ini tercantum di setiap halaman model. Parameter yang tidak Anda isi dihitung sebagai nilai bawaannya, sehingga harga yang Anda lihat untuk suatu input adalah harga yang Anda bayar.

Harga pasti, terukur, estimasi, dan berdasarkan penggunaan#

Setiap harga memiliki mode:

• exact: harga dihitung dari input Anda (detik, gambar, megapiksel, karakter, langkah, atau satu harga tetap per video atau panggilan).
• measured: harga mengikuti file yang Anda kirim: durasi video atau audio input, ukuran gambar input, laju bingkai atau jumlah bingkai video. Upscaler, sinkronisasi bibir, video-ke-video, transkripsi, dan tool audio dihargai dengan cara ini. Sebelum dijalankan, API membaca durasi, resolusi, dan laju bingkai file (kuotasi juga melakukan hal yang sama), sehingga kuotasi persis sama dengan biaya proses. Halaman model menjelaskan biaya yang berlaku ("Harga per detik video input Anda") dan kalkulatornya menggunakan angka dari file Anda. File yang tidak dapat dibaca ditolak dengan unmeasurable_input dan tidak ada biaya.
• estimate: biaya model bergantung pada sesuatu yang tidak dapat diketahui input sebelumnya (token, waktu komputasi). Model tersebut mengenakan harga estimasi tetap per proses (per gambar output jika memiliki jumlah gambar), yang ditetapkan berdasarkan biaya rata-rata proses nyata model tersebut. Anda tetap mengetahui harganya sebelum menjalankan: kuotasi adalah harga yang Anda bayar.
• metered: model ditagih berdasarkan penggunaan aktual, yang hanya diketahui oleh proses itu sendiri: token yang dibaca dan ditulis model bahasa atau visi, detik ucapan yang dihasilkan model suara, atau waktu pemrosesan model. Lihat Ditagih berdasarkan penggunaan di bawah.

Halaman model menampilkan "Harga per proses", "Harga per detik video input Anda" (dan sejenisnya), "Harga estimasi per proses", atau "Ditagih berdasarkan penggunaan"; GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate dan ?mode=metered menampilkannya.

Ditagih berdasarkan penggunaan#

Model metered memiliki harga penggunaan ("$0.01 per 1000 token", "$0.002 per detik audio yang dihasilkan", "$0.00111 per detik waktu pemrosesan") dan maksimum per proses: biaya terbesar yang mungkin dikenakan proses, berdasarkan isi permintaan Anda (max_tokens, panjang teks, resolusi, jumlah output) dan batas model yang dipublikasikan. Biaya ini tidak pernah bergantung pada isi file di balik URL. Untuk model yang ditagih berdasarkan waktu pemrosesan atau durasi sesi suara, maksimum adalah durasi terlama permintaan dapat berjalan (15 menit untuk gambar, 30 untuk audio, 60 untuk video), sehingga jauh di atas proses biasa. Input yang maksimum biayanya melebihi batas per proses model (teks yang sangat panjang) ditolak dengan 422 invalid_input:

1. Kuotasi mengembalikan maksimum tersebut sebagai credits (dengan hold dan typical, yaitu proses biasa). Saat proses dimulai, maksimum dipotong dari saldo API, dan saldo serta anggaran kunci Anda harus mencukupinya.
2. Saat proses berhasil, permintaan diselesaikan sesuai penggunaan yang dilaporkan model: penggunaan × harga penggunaan, dibulatkan ke atas menjadi kredit API bulat. Sisa maksimum otomatis dikembalikan, satu kali, sebagai baris refund pada saldo API.
3. Proses tidak pernah berbiaya lebih dari maksimumnya. Proses yang gagal atau dibatalkan selalu menerima pengembalian dana penuh.

Sebagian besar proses berbiaya jauh lebih rendah daripada maksimum; halaman model menampilkan "Hingga $X per proses" untuk input builder dan proses biasa ("dari" dalam katalog). Untuk beberapa model yang ditagih berdasarkan waktu pemrosesan, penggunaan adalah waktu pemrosesan model (ditandai 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"
}

Setelah proses, cost pada permintaan menunjukkan jumlah yang ditahan dan penggunaan aktual:

{
  "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 adalah biaya proses. settled.status bernilai pending selama jeda antara hasil dan penyelesaian, dan no_usage dalam kasus jarang ketika model tidak melaporkan penggunaan sama sekali (saat itu maksimum menjadi harga).

Kuotasi sebelum menjalankan#

POST https://api.doitong.com/v1/quote/{model_id} menerima body yang sama persis dengan yang akan Anda kirim ke run dan mengembalikan harga input tersebut: harga pasti, kecuali untuk model yang ditagih berdasarkan penggunaan, yang mengembalikan biaya maksimum proses. Endpoint ini tidak memerlukan kunci dan tidak berbiaya:

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": []
}

Dengan kunci, kuotasi juga mengembalikan balance_credits dan balance_usd (saldo API Anda), affordable dan key_budget_remaining. Tambahkan ?currency=rub untuk jumlah rub.

Objek harga#

Setiap harga di API memiliki 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" } — ditambah 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 menambahkan mode, held, typical dan settled, lihat Ditagih berdasarkan penggunaan);
• account: GET https://api.doitong.com/v1/account mengembalikan credits (saldo API), balance: { "credits", "usd" } dan storage (harga penyimpanan file, penggunaan, dan estimasi bulanan).

Pengembalian dana#

• Permintaan tidak valid (setiap 4xx sebelum proses dimulai) tidak pernah dikenai biaya.
• Permintaan yang berakhir failed (termasuk timeout) menerima pengembalian dana penuh ke saldo API secara otomatis.
• Permintaan yang Anda batalkan sebelum dimulai menerima pengembalian dana penuh. Setelah model mulai menghasilkan, pembatalan hanya menjadi permintaan: jika model selesai, hasil dikirim dan dikenai biaya.
• Permintaan metered yang berhasil mendapatkan kembali bagian maksimum yang tidak digunakan.

Objek permintaan menampilkan semuanya: cost.credits, cost.charged dan cost.refunded.

Penyimpanan file#

File output disimpan di penyimpanan kami. Anda dapat memilihnya di akun atau per proses (?storage=):

Penyimpanan permanen dikenai biaya sekali sehari dari saldo API: GB yang disimpan × harga bulanan ÷ jumlah hari dalam bulan, sebagai baris ledger dengan jenis storage. Pecahan kredit API dibawa ke hari berikutnya, sehingga total sebulan tepat sebesar GB × 100 kredit API (1 GB = 1024³ byte; 10 GB yang disimpan selama sebulan berbiaya 1.000 kredit API). Saldo tidak pernah kurang dari nol: jika tidak dapat membayar, hari tersebut tidak dikenai biaya, Anda menerima email, dan memiliki 30 hari untuk isi ulang sebelum file yang disimpan menjadi sementara dan dihapus 7 hari kemudian. Detail: File.

Harga saat ini#

Ini adalah model unggulan. Semua 1.496 model dan harganya tersedia di katalog model dan di GET /models (tidak memerlukan kunci).

Isi ulang#

Tambahkan dana ke saldo API di https://doitong.com/developers/dashboard#balance. Jika saldo terlalu rendah, proses mengembalikan 402 insufficient_credits dengan top_up_url. Setiap kunci API juga dapat dibatasi dengan anggarannya sendiri dalam kredit API (lihat Autentikasi).