Cene

Vsak model stane natanko toliko, kolikor zanj zaračuna njegov izdelovalec, v ameriških dolarjih. Plačate iz svojega stanja API, ki se obračunava v kreditih API: 1000 API kreditov = 1 $. Stanje API je ločeno stanje, neodvisno od kreditov aplikacij Doitong. Ni paketov, minimumov ali pristojbin na model: klic stane svojo ceno, ki se odšteje od stanja API, ko je zahteva sprejeta.

V Rusiji (doitong.ru, api.doitong.ru ali ?currency=rub) so cene prikazane tudi v rubljih: cena v USD × tečaj USD/RUB × 1,3.

Enote#

Vsak model ima eno obračunsko enoto, prikazano na svoji strani in v GET https://api.doitong.com/v1/models/{model_id}:

Cena = količina × krediti API na enoto, zaokroženo navzgor na cel kredit API (0,001 $), vendar nikoli manj kot 1. Zelo poceni enote imajo lahko delno ceno na enoto (0.4 kredita API na sekundo); zaokroži se samo skupna cena klica.

Nekateri modeli zaračunajo drugačno tarifo glede na vhod: video z zvokom stane več kot brez njega, 4K več kot 1K in tako naprej. Ta pravila so navedena na strani vsakega modela. Parameter, ki ga izpustite, šteje kot njegova privzeta vrednost, zato je cena, ki jo vidite za vhod, cena, ki jo plačate.

Natančne, izmerjene, ocenjene cene in cene glede na uporabo#

Vsaka cena ima mode:

• exact: cena se izračuna iz vašega vhoda (sekunde, slike, megapiksli, znaki, koraki ali ena pavšalna cena na video ali klic).
• measured: cena sledi poslanim datotekam: dolžini vhodnega videa ali zvoka, velikosti vhodne slike, hitrosti sličic ali številu sličic videa. Tako se obračunajo povečanje ločljivosti, sinhronizacija ustnic, video-v-video, prepisovanje in zvočna orodja. Pred zagonom API prebere dolžino, ločljivost in hitrost sličic datoteke (enako stori izračun), zato je izračun natanko to, kar se zaračuna pri zagonu. Stran modela pove, za kaj plačate ("Cena na sekundo vašega vhodnega videa"), njegov kalkulator pa uporabi številke vaše datoteke. Datoteka, ki je ni mogoče prebrati, je zavrnjena z unmeasurable_input in nič se ne zaračuna.
• estimate: lastna cena modela je odvisna od nečesa, česar vhod ne more vnaprej razkriti (žetonov, časa računanja). Tak model zaračuna fiksno ocenjeno ceno na zagon (na izhodno sliko, ko ima število slik), določeno iz povprečne cene dejanskih zagonov tega modela. Ceno še vedno poznate pred zagonom: izračun je cena, ki jo plačate.
• metered: model se obračuna glede na dejansko uporabo, ki jo pozna samo sam zagon: žetone, ki jih jezikovni ali vidni model prebere in zapiše, sekunde govora, ki jih ustvari glasovni model, ali čas obdelave modela. Glejte spodaj Obračun glede na uporabo.

Strani modelov navajajo »Cena na zagon«, »Cena na sekundo vašega vhodnega videa« (in podobno), »Ocenjena cena na zagon« ali »Obračun glede na uporabo«; GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate in ?mode=metered jih izpišejo.

Obračun glede na uporabo#

Model metered ima ceno glede na uporabo (»$0.01 na 1000 žetonov«, »$0.002 na sekundo ustvarjenega zvoka«, »$0.00111 na sekundo časa obdelave«) in največjo ceno na zagon: največ, kar lahko stane zagon, glede na to, kar pove vaša zahteva (max_tokens, dolžino besedila, ločljivost, število izhodov) in objavljene omejitve modela. Nikoli ni odvisna od vsebine datoteke za URL-jem. Pri modelu, obračunanem glede na čas obdelave ali dolžino glasovne seje, je največja cena najdaljši čas, ki ga lahko zahteva teče (15 minut za slike, 30 za zvok, 60 za video), zato je precej višja od običajnega zagona. Vhod, pri katerem bi bila največja cena nad omejitvijo modela na zagon (zelo dolgo besedilo), je zavrnjen z 422 invalid_input:

1. Izračun vrne to največjo ceno kot credits (z hold in typical, običajnim zagonom). Ko se zagon začne, se največja cena odšteje od stanja API in je znesek, ki ga morata pokriti stanje in proračun ključa.
2. Ko je zagon uspešen, se zahteva poravna glede na uporabo, ki jo model zanjo sporoči: uporaba × cena uporabe, zaokroženo navzgor na cel kredit API. Preostanek največje cene se samodejno povrne, enkrat, kot vrstica refund v vašem stanju API.
3. Zagon nikoli ne stane več od svoje največje cene, tudi če bi uporaba to zahtevala. Neuspešen ali preklican zagon se kot vedno povrne v celoti.

Večina zagonov stane precej manj od največje cene; stran modela za vhod gradnika prikazuje »Do $X na zagon« in običajni zagon (»from« v katalogu). Pri nekaj modelih, obračunanih glede na čas obdelave, je uporaba čas obdelave modela (označen z 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"
}

Po zagonu cost zahteve prikaže zadržani znesek in znesek uporabe:

{
  "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 je cena zagona. settled.status je pending v trenutku med rezultatom in poravnavo, no_usage pa v redkem primeru, ko model sploh ne sporoči uporabe (takrat največja cena ostane cena).

Izračun pred zagonom#

POST https://api.doitong.com/v1/quote/{model_id} sprejme natanko telo, ki bi ga poslali v run, in vrne ceno tega vhoda: natančno ceno, razen pri modelu obračunanem glede na uporabo, kjer je to največ, kar lahko zagon stane. Ključa ne potrebuje in nič ne stane:

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

S ključem izračun vrne tudi balance_credits in balance_usd (vaše stanje API), affordable in key_budget_remaining. Dodajte ?currency=rub za znesek v rub.

Objekti cen#

Vsaka cena v API ima enako obliko:

• modeli: 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" } — v Rusiji ali z ?currency=rub še rub, rub_display in from_rub;
• zahteve: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (krediti API; zahteva metered doda mode, held, typical in settled, glejte Obračun glede na uporabo);
• račun: GET https://api.doitong.com/v1/account vrne credits (stanje API), balance: { "credits", "usd" } in storage (ceno shrambe datotek, uporabo in mesečno oceno).

Vračila#

• Neveljavna zahteva (kateri koli 4xx pred začetkom zagona) se nikoli ne zaračuna.
• Zahteva, ki se konča z failed (vključno z timeout), se samodejno v celoti povrne v stanje API.
• Zahteva, ki jo prekličete pred začetkom, se v celoti povrne. Ko model začne ustvarjati, je preklic le zahteva: če model dokonča delo, se rezultat dostavi in zaračuna.
• Uspešna zahteva metered dobi nazaj del največje cene, ki ga ni porabila.

Objekt zahteve prikaže vse: cost.credits, cost.charged in cost.refunded.

Shramba datotek#

Izhodne datoteke se hranijo v naši shrambi. Izberete lahko v računu ali pri posameznem zagonu (?storage=):

Trajna shramba se enkrat na dan zaračuna iz stanja API: shranjeni GB × mesečna cena ÷ število dni v mesecu, kot knjigovodske vrstice vrste storage. Deli kredita API se prenesejo v naslednji dan, zato mesec skupaj znaša natanko GB × 100 kreditov API (1 GB = 1024³ bajtov; 10 GB, hranjenih en mesec, stane 1000 kreditov API). Stanje nikoli ne pade pod nič: ko plačilo ni mogoče, se ta dan ne zaračuna, dobite e-poštno sporočilo in imate 30 dni za dopolnitev dobroimetja, preden shranjene datoteke postanejo začasne in se 7 dni pozneje izbrišejo. Podrobnosti: Datoteke.

Trenutne cene#

To so izpostavljeni modeli. Vseh 1496 modelov in njihove cene je v katalogu modelov ter v GET /models (ključ ni potreben).

Dopolnitev dobroimetja#

Dodajte sredstva v stanje API na https://doitong.com/developers/dashboard#balance. Ko je stanje prenizko, zagon vrne 402 insufficient_credits z top_up_url. Vsak ključ API je mogoče omejiti tudi z lastnim proračunom v kreditih API (glejte Preverjanje pristnosti).