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}:

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 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).

{
  "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:

{
  "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, yang mengembalikan jumlah maksimum yang boleh dikenakan. Ia tidak memerlukan kunci dan tidak berharga apa-apa:

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, sebut harga turut mengembalikan balance_credits dan balance_usd (baki API anda), affordable dan key_budget_remaining. Tambah ?currency=rub untuk jumlah rub.

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);
• 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=):

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.

Harga semasa#

Ini ialah model pilihan. Semua 1,496 model dan harganya tersedia dalam katalog model dan dalam GET /models (tidak memerlukan kunci).

Tambah nilai#

Tambah wang ke baki API di 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).