Fiyatlandırma

Her model, üreticisinin talep ettiği ücret kadar, ABD doları cinsinden ücretlendirilir. Ödemeyi API kredisi cinsinden hesaplanan API bakiyenizden yaparsınız: 1.000 API kredisi = $1. API bakiyesi, Doitong uygulamalarının kredilerinden ayrı, kendi bakiyesidir. Plan, minimum tutar veya model başına ücret yoktur: bir çağrı kendi fiyatına mal olur ve istek kabul edildiğinde API bakiyesinden düşülür.

Rusya'da (doitong.ru, api.doitong.ru veya ?currency=rub) fiyatlar ruble olarak da gösterilir: USD fiyatı × USD/RUB kuru × 1,3.

Birimler#

Her modelin, sayfasında ve GET https://api.doitong.com/v1/models/{model_id} içinde gösterilen bir faturalandırma birimi vardır:

Fiyat = miktar × birim başına API kredisi; tam API kredisine yuvarlanır ($0,001), hiçbir zaman 1'den az olmaz. Çok ucuz birimlerin birim başına kesirli fiyatı olabilir (0.4 saniye başına API kredisi); yalnızca çağrının toplamı yuvarlanır.

Bazı modeller, girdiye göre farklı ücret alır: sesli video sessiz videodan, 4K 1K'dan daha pahalıdır ve benzeri. Bu kurallar her model sayfasında listelenir. Atladığınız bir parametre varsayılan değeriyle hesaba katılır; bu nedenle bir girdi için gördüğünüz fiyat ödediğiniz fiyattır.

Kesin, ölçülen, tahmini ve kullanım fiyatları#

Her fiyatın bir mode değeri vardır:

• exact: Fiyat girdinizden hesaplanır (saniyeler, görseller, megapikseller, karakterler, adımlar veya video ya da çağrı başına sabit fiyat).
• measured: Fiyat gönderdiğiniz dosyaları izler: girdi videosu veya sesinin uzunluğu, girdi görselinin boyutu, videonun kare hızı veya kare sayısı. Görüntü büyütücüler, dudak senkronu, videodan videoya dönüşüm, transkripsiyon ve ses araçları bu şekilde fiyatlandırılır. Çalıştırmadan önce API dosyanın uzunluğunu, çözünürlüğünü ve kare hızını okur (fiyat teklifi de aynısını yapar); bu nedenle teklif, çalıştırmanın ücretlendireceği tutarın aynısıdır. Model sayfası ne için ödeme yaptığınızı belirtir ("Girdi videonuzun saniye başına fiyatı") ve hesaplayıcısı dosyanızın sayılarını kullanır. Okunamayan bir dosya unmeasurable_input ile reddedilir ve ücret alınmaz.
• estimate: Modelin kendi maliyeti, girdinin önceden söyleyemediği bir şeye bağlıdır (token'lar, işlem süresi). Böyle bir model, o modelin gerçek çalıştırmalarının ortalama maliyetinden belirlenen sabit bir çalıştırma başına tahmini fiyat (görsel sayısı varsa çıktı görseli başına) uygular. Çalıştırmadan önce fiyatı yine bilirsiniz: teklif, ödeyeceğiniz tutardır.
• metered: Model, yalnızca çalıştırmanın bilebildiği gerçek kullanıma göre ücretlendirilir: dil veya görsel modelinin okuyup yazdığı token'lar, ses modelinin oluşturduğu konuşma saniyeleri veya modelin işlem süresi. Aşağıdaki Kullanıma göre ücretlendirme bölümüne bakın.

Model sayfalarında "Çalıştırma başına fiyat", "Girdi videonuzun saniye başına fiyatı" (ve benzerleri), "Çalıştırma başına tahmini fiyat" veya "Kullanıma göre ücretlendirilir" ifadeleri yer alır; GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate ve ?mode=metered bunları listeler.

Kullanıma göre ücretlendirme#

metered modelinin bir kullanım fiyatı ("1000 token başına $0.01", "oluşturulan sesin saniyesi başına $0.002", "işlem süresinin saniyesi başına $0.00111") ve çalıştırma başına maksimum ücreti vardır: isteğinizin belirttiği bilgiler (max_tokens, metninizin uzunluğu, çözünürlük, çıktı sayısı) ve modelin yayımlanmış sınırlarına göre çalıştırmanın maliyetinin çıkabileceği en yüksek tutar. Bu tutar, URL arkasındaki dosyanın içeriğine hiçbir zaman bağlı değildir. İşlem süresine veya ses oturumunun uzunluğuna göre faturalandırılan bir modelde maksimum, bir isteğin çalışabileceği en uzun süredir (görseller için 15 dakika, ses için 30, video için 60); bu nedenle tipik bir çalıştırmadan çok daha yüksektir. Maksimumu modelin çalıştırma başına sınırını aşacak bir girdi (çok uzun bir metin) 422 invalid_input ile reddedilir:

1. Teklif bu maksimumu credits olarak döndürür (hold ve tipik bir çalıştırma olan typical ile). Çalıştırma başladığında maksimum tutar API bakiyesinden düşülür ve bakiye ile anahtar bütçenizin karşılaması gereken tutar budur.
2. Çalıştırma başarılı olduğunda istek, modelin bildirdiği kullanıma göre kesinleştirilir: kullanım × kullanım fiyatı; tam API kredisine yuvarlanır. Maksimum tutarın geri kalanı otomatik olarak iade edilir, bir kez, API bakiyenizde refund satırı olarak.
3. Kullanımı daha yüksek olsa bile bir çalıştırmanın maliyeti maksimumu aşmaz. Başarısız veya iptal edilmiş bir çalıştırma her zaman olduğu gibi tamamen iade edilir.

Çoğu çalıştırmanın maliyeti maksimumdan çok daha düşüktür; model sayfası oluşturucunun girdisi için "Çalıştırma başına $X'e kadar" ve tipik çalıştırmayı (katalogda "from") gösterir. İşlem süresine göre faturalandırılan birkaç modelde kullanım, modelin işlem süresidir (approximate olarak işaretlenir).

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

Çalıştırmadan sonra isteğin cost alanı, tutulan ve kullanımın oluşturduğu tutarı gösterir:

{
  "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, çalıştırmanın maliyetidir. settled.status, sonuç ile kesinleştirme arasındaki anda pending, modelin hiç kullanım bildirmediği nadir durumda (bu durumda maksimum fiyat olarak kalır) no_usage değerindedir.

Çalıştırmadan önce teklif alın#

POST https://api.doitong.com/v1/quote/{model_id}, run için göndereceğiniz gövdenin aynısını alır ve bu girdinin fiyatını döndürür: kullanım kullanıma göre ücretlendirilen bir model dışında kesin fiyat; bu durumda çalıştırmanın maliyetinin çıkabileceği en yüksek tutardır. Anahtar gerektirmez ve ücretsizdir:

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

Anahtarla teklif ayrıca balance_credits ve balance_usd (API bakiyeniz), affordable ve key_budget_remaining değerlerini döndürür. rub tutarı için ?currency=rub ekleyin.

Fiyat nesneleri#

API'deki her fiyat aynı yapıya sahiptir:

• 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" } — Rusya'da veya ?currency=rub ile ayrıca rub, rub_display ve from_rub;
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (API kredisi; metered bir istek mode, held, typical ve settled ekler, Kullanıma göre ücretlendirme bölümüne bakın);
• account: GET https://api.doitong.com/v1/account, credits (API bakiyesi), balance: { "credits", "usd" } ve storage (dosya depolama fiyatı, kullanımı ve aylık tahmini) döndürür.

İadeler#

• Geçersiz bir istek (çalıştırma başlamadan önceki herhangi bir 4xx) için hiçbir zaman ücret alınmaz.
• failed durumunda sona eren bir istek (timeout dahil) API bakiyesine otomatik olarak tamamen iade edilir.
• Başlamadan önce iptal ettiğiniz bir istek tamamen iade edilir. Model üretmeye başladıktan sonra iptal yalnızca bir istektir: model tamamlanırsa sonuç teslim edilir ve ücret alınır.
• Başarılı olan bir metered isteğinde, maksimum tutarın kullanılmayan kısmı geri verilir.

İstek nesnesi tüm bilgileri gösterir: cost.credits, cost.charged ve cost.refunded.

Dosya depolama#

Çıktı dosyaları depolamamızda tutulur. Hesapta veya çalıştırma başına (?storage=) seçim yaparsınız:

Kalıcı depolama, API bakiyesinden günde bir kez ücretlendirilir: tutulan GB × aylık fiyat ÷ aydaki gün sayısı; kayıt defterinde storage türünde satırlar oluşturulur. API kredisinin kesirleri sonraki güne aktarılır; bu nedenle bir ayın toplamı tam olarak GB × 100 API kredisi olur (1 GB = 1024³ bayt; bir ay tutulan 10 GB'ın maliyeti 1.000 API kredisidir). Bakiye hiçbir zaman sıfırın altına inmez: ödeme yapılamadığında o gün ücret alınmaz, e-posta alırsınız ve tutulan dosyalar geçici hâle gelip 7 gün sonra silinmeden önce bakiye yüklemek için 30 gününüz olur. Ayrıntılar: Dosyalar.

Güncel fiyatlar#

Bunlar öne çıkan modellerdir. 1.496 modelin tamamı ve fiyatları model kataloğunda ve GET /models içinde (anahtar gerekmez) yer alır.

Bakiye yükleme#

https://doitong.com/developers/dashboard#balance adresinden API bakiyesine para ekleyin. Bakiye çok düşük olduğunda çalıştırma top_up_url ile birlikte 402 insufficient_credits döndürür. Her API anahtarına API kredisi cinsinden kendi bütçesi için sınır da koyulabilir (Kimlik doğrulama bölümüne bakın).