Kainodara

Kiekvienas modelis kainuoja tiksliai tiek, kiek už jį ima jo kūrėjas, JAV doleriais. Mokate iš savo API likučio, kuris skaičiuojamas API kreditais: 1 000 API kreditų = 1 $. API likutis yra atskiras likutis, nesusijęs su Doitong programėlių kreditais. Planų, minimalių sumų ar mokesčių už modelį nėra: iškvietimas kainuoja jo kainą, kuri iš API likučio nuskaičiuojama priėmus užklausą.

Rusijoje (doitong.ru, api.doitong.ru arba naudojant ?currency=rub) kainos taip pat rodomos rubliais: USD kaina × USD/RUB kursas × 1,3.

Vienetai#

Kiekvienas modelis turi vieną atsiskaitymo vienetą, rodomą jo puslapyje ir GET https://api.doitong.com/v1/models/{model_id}:

Kaina = kiekis × API kreditų skaičius vienetui, suapvalinta į didesnę pusę iki sveiko API kredito (0,001 $), bet ne mažesnė nei 1. Labai pigūs vienetai gali turėti trupmeninę kainą už vienetą (0.4 API kredito už sekundę); apvalinama tik bendra iškvietimo suma.

Kai kurie modeliai taiko skirtingą tarifą priklausomai nuo įvesties: vaizdo įrašas su garsu kainuoja daugiau nei be jo, 4K kainuoja daugiau nei 1K ir taip toliau. Šios taisyklės pateikiamos kiekvieno modelio puslapyje. Nepateiktas parametras laikomas turinčiu numatytąją reikšmę, todėl įvesties kaina, kurią matote, yra ta, kurią mokate.

Tikslios, išmatuotos, apskaičiuotos ir pagal naudojimą nustatomos kainos#

Kiekviena kaina turi mode:

• exact: kaina apskaičiuojama pagal jūsų įvestį (sekundes, vaizdus, megapikselius, simbolius, žingsnius arba vienodą kainą už vaizdo įrašą ar iškvietimą).
• measured: kaina priklauso nuo jūsų siunčiamų failų: įvesties vaizdo įrašo arba garso trukmės, įvesties vaizdo dydžio, vaizdo įrašo kadrų dažnio arba kadrų skaičiaus. Taip kainuojami raiškos didinimo, lūpų sinchronizavimo, vaizdo į vaizdą, transkripcijos ir garso įrankiai. Prieš paleidžiant API nuskaito failo trukmę, raišką ir kadrų dažnį (tą patį atlieka ir kainos pasiūlymas), todėl pasiūlyta kaina tiksliai atitinka paleidimo kainą. Modelio puslapyje nurodoma, už ką mokate ("Kaina už jūsų įvesties vaizdo įrašo sekundę"), o skaičiuotuvas naudoja jūsų failo duomenis. Failas, kurio nepavyksta perskaityti, atmetamas su unmeasurable_input, o mokestis netaikomas.
• estimate: tikroji modelio kaina priklauso nuo to, ko įvestis iš anksto neatskleidžia (žetonų, skaičiavimo laiko). Toks modelis taiko fiksuotą apskaičiuotą kainą už paleidimą (už išvesties vaizdą, kai nurodomas vaizdų skaičius), nustatytą pagal faktinių šio modelio paleidimų vidutinę kainą. Kainą vis tiek žinote prieš paleisdami: pasiūlyta kaina yra ta, kurią mokate.
• metered: modelis apmokestinamas pagal faktinį naudojimą, kurį žino tik pats paleidimas: kalbos arba vaizdo modelio perskaitytus ir sugeneruotus žetonus, balso modelio sugeneruoto kalbėjimo sekundes arba modelio apdorojimo laiką. Žr. toliau pateiktą skiltį Apmokestinama pagal naudojimą.

Modelių puslapiuose rašoma "Kaina už paleidimą", "Kaina už jūsų įvesties vaizdo įrašo sekundę" (ir panašiai), "Apskaičiuota kaina už paleidimą" arba "Apmokestinama pagal naudojimą"; GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate ir ?mode=metered juos išvardija.

Apmokestinama pagal naudojimą#

metered modelis turi naudojimo kainą ("$0.01 už 1000 žetonų", "$0.002 už sugeneruoto garso sekundę", "$0.00111 už apdorojimo laiko sekundę") ir didžiausią kainą už paleidimą: didžiausią sumą, kurią gali kainuoti paleidimas, nustatomą pagal tai, ką nurodo jūsų užklausa (max_tokens, teksto ilgį, raišką, išvesčių skaičių) ir paskelbtus modelio apribojimus. Ji niekada nepriklauso nuo URL nurodyto failo turinio. Modelio, apmokestinamo pagal apdorojimo laiką arba balso seanso trukmę, didžiausia kaina atitinka ilgiausią galimą užklausos trukmę (15 minučių vaizdams, 30 garsui, 60 vaizdo įrašui), todėl ji gerokai viršija įprasto paleidimo kainą. Įvestis, kurios didžiausia kaina viršytų modelio paleidimo ribą (labai ilgas tekstas), atmetama su 422 invalid_input:

1. Kainos pasiūlymas grąžina šią didžiausią sumą kaip credits (su hold ir typical, įprastu paleidimu). Paleidus, didžiausia suma nuskaičiuojama iš API likučio, todėl ją turi padengti likutis ir jūsų rakto biudžetas.
2. Kai paleidimas sėkmingas, užklausa galutinai apskaičiuojama pagal modelio praneštą naudojimą: naudojimas × naudojimo kaina, suapvalinta į didesnę pusę iki sveiko API kredito. Likusi didžiausios sumos dalis grąžinama automatiškai, vieną kartą, kaip refund eilutė jūsų API likutyje.
3. Paleidimas niekada nekainuoja daugiau nei didžiausia jo kaina, net jei naudojimas tai lemtų. Nepavykęs arba atšauktas paleidimas visada grąžinamas visas.

Dauguma paleidimų kainuoja gerokai mažiau nei didžiausia suma; modelio puslapyje rodomas "Iki $X už paleidimą" kūrėjo įvesties atveju ir įprastas paleidimas (kataloge – "nuo"). Kelių modelių, apmokestinamų pagal apdorojimo laiką, naudojimas yra modelio apdorojimo laikas (pažymėtas 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 paleidimo užklausos cost rodo, kas buvo rezervuota ir kiek sudarė naudojimas:

{
  "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 yra paleidimo kaina. settled.status yra pending laikotarpiu nuo rezultato gavimo iki atsiskaitymo, o no_usage retu atveju, kai modelis apskritai nepranešė apie naudojimą (tuomet didžiausia suma lieka kaina).

Kainos pasiūlymas prieš paleidžiant#

POST https://api.doitong.com/v1/quote/{model_id} priima tiksliai tą turinį, kurį siųstumėte į run, ir grąžina šios įvesties kainą: tikslią kainą, išskyrus modelį, apmokestinamą pagal naudojimą, kurio atveju tai yra didžiausia galima paleidimo kaina. Rakto nereikia ir nieko nekainuoja:

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

Naudojant raktą, kainos pasiūlyme taip pat pateikiami balance_credits ir balance_usd (jūsų API likutis), affordable ir key_budget_remaining. Pridėkite ?currency=rub, kad gautumėte rub sumą.

Kainos objektai#

Kiekviena API kaina turi tokią pačią struktūrą:

• 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" } – taip pat rub, rub_display ir from_rub Rusijoje arba naudojant ?currency=rub;
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (API kreditai; metered užklausoje papildomai pateikiami mode, held, typical ir settled, žr. Apmokestinama pagal naudojimą);
• account: GET https://api.doitong.com/v1/account grąžina credits (API likutį), balance: { "credits", "usd" } ir storage (failų saugyklos kainą, naudojimą ir mėnesio sąmatą).

Grąžinimai#

• Už netinkamą užklausą (bet kurią 4xx prieš paleidimo pradžią) mokestis niekada netaikomas.
• Užklausa, kuri baigiasi failed (įskaitant timeout), automatiškai grąžinama visa į API likutį.
• Užklausa, kurią atšaukiate prieš paleidimą, grąžinama visa. Modeliui pradėjus generuoti, atšaukimas yra tik užklausa: jei modelis baigia darbą, rezultatas pateikiamas ir už jį mokama.
• Sėkmingos metered užklausos nepanaudota didžiausios sumos dalis grąžinama.

Užklausos objektas rodo visą informaciją: cost.credits, cost.charged ir cost.refunded.

Failų saugykla#

Išvesties failai saugomi mūsų saugykloje. Pasirenkate paskyroje arba kiekvienam paleidimui (?storage=):

Už nuolatinę saugyklą kartą per dieną mokama iš API likučio: saugomas GB kiekis × mėnesio kaina ÷ mėnesio dienų skaičius, žurnalo eilutėse su rūšimi storage. API kreditų trupmenos perkeliamos į kitą dieną, todėl per mėnesį susidaro tiksliai GB × 100 API kreditų (1 GB = 1024³ baitai; 10 GB saugojimas mėnesį kainuoja 1 000 API kreditų). Likutis niekada nenukrenta žemiau nulio: kai mokėti neįmanoma, tą dieną mokestis netaikomas, gaunate el. laišką ir turite 30 dienas likutį papildyti, kol saugomi failai taps laikini ir bus ištrinti po 7 dienų. Išsami informacija: Failai.

Dabartinės kainos#

Tai yra rekomenduojami modeliai. Visi 1 496 modelių duomenys ir kainos pateikti modelių kataloge ir GET /models (rakto nereikia).

Papildymas#

Papildykite API likutį adresu https://doitong.com/developers/dashboard#balance. Kai likutis per mažas, paleidimas grąžina 402 insufficient_credits su top_up_url. Kiekvienam API raktui taip pat galima nustatyti atskirą biudžetą API kreditais (žr. Autentifikavimas).