Hinnoittelu

Jokainen malli maksaa täsmälleen sen, mitä mallin valmistaja siitä veloittaa, Yhdysvaltain dollareina. Maksat API-saldostasi, joka ilmoitetaan API-krediitteinä: 1 000 API-krediittiä = 1 $. API-saldo on oma saldonsa, erillään Doitong-sovellusten krediiteistä. Paketteja, vähimmäisveloituksia tai mallikohtaisia maksuja ei ole: kutsu maksaa hintansa, joka vähennetään API-saldosta, kun pyyntö hyväksytään.

Venäjällä (doitong.ru, api.doitong.ru tai ?currency=rub) hinnat näytetään myös ruplina: USD-hinta × USD/RUB-kurssi × 1,3.

Yksiköt#

Jokaisella mallilla on yksi laskutusyksikkö, joka näytetään sen sivulla ja kutsussa GET https://api.doitong.com/v1/models/{model_id}:

Hinta = määrä × API-krediitit yksikköä kohti, pyöristettynä ylöspäin kokonaiseksi API-krediitiksi (0,001 $), vähintään 1. Hyvin halvoilla yksiköillä voi olla murtolukuhinta yksikköä kohti (0.4 API-krediittiä sekunnilta); vain kutsun kokonaishinta pyöristetään.

Jotkin mallit veloittavat eri hinnan syötteen mukaan: äänellinen video maksaa enemmän kuin äänetön, 4K enemmän kuin 1K ja niin edelleen. Nämä säännöt luetellaan jokaisella mallin sivulla. Pois jätetty parametri lasketaan oletusarvokseen, joten syötteelle näkemäsi hinta on maksamasi hinta.

Täsmälliset, mitatut, arvioidut ja käytön mukaan määräytyvät hinnat#

Jokaisella hinnalla on mode:

• exact: hinta lasketaan syötteestäsi (sekunneista, kuvista, megapikseleistä, merkeistä, vaiheista tai kiinteästä videokohtaisesta tai kutsukohtaisesta hinnasta).
• measured: hinta perustuu lähettämiisi tiedostoihin: syötevideon tai -äänen pituuteen, syötekuvan kokoon tai videon ruutunopeuteen tai ruutujen määrään. Skaalaimet, huulisynkronointi, video videoksi, litterointi ja äänityökalut hinnoitellaan näin. Ennen ajoa API lukee tiedoston pituuden, resoluution ja ruutunopeuden (samoin tekee hintalaskelma), joten hintalaskelma vastaa täsmälleen ajon veloitusta. Mallin sivulla kerrotaan, mistä maksat ("Hinta syötevideon sekuntia kohti"), ja laskin käyttää tiedostosi arvoja. Tiedosto, jota ei voi lukea, hylätään virheellä unmeasurable_input, eikä mitään veloiteta.
• estimate: mallin oma hinta riippuu jostakin, mitä syötteestä ei voi etukäteen päätellä (sanakkeista tai laskenta-ajasta). Tällainen malli veloittaa kiinteän arvioidun ajo­kohtaisen hinnan (kuvamäärän sisältävillä malleilla tulostekuvaa kohti), joka perustuu kyseisen mallin todellisten ajojen keskimääräiseen hintaan. Tiedät silti hinnan ennen ajoa: hintalaskelma on maksamasi hinta.
• metered: mallista veloitetaan todellisen käytön mukaan, jonka vain ajo itse tietää: kieli- tai näkömallin lukemat ja kirjoittamat sanakkeet, äänimallin tuottaman puheen sekunnit tai mallin käsittelyaika. Katso alta Käytön mukaan veloitettavat.

Mallien sivuilla lukee "Hinta ajoa kohti", "Hinta syötevideon sekuntia kohti" (ja vastaavasti), "Arvioitu hinta ajoa kohti" tai "Veloitetaan käytön mukaan"; kutsut GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate ja ?mode=metered luettelevat ne.

Käytön mukaan veloitettavat#

metered-mallilla on käyttöhinta ("$0.01 per 1000 sanaketta", "$0.002 tuotetun äänen sekunnilta", "$0.00111 käsittelyajan sekunnilta") ja enimmäishinta ajoa kohti: suurin summa, jonka ajo voi maksaa pyyntösi tietojen (max_tokens, tekstisi pituus, resoluutio, tulosteiden määrä) ja mallin julkaistujen rajojen perusteella. Se ei koskaan riipu URL-osoitteen takana olevan tiedoston sisällöstä. Käsittelyajan tai äänisession pituuden mukaan laskutettavilla malleilla enimmäishinta on pisin sallittu ajo (kuville 15 minuuttia, äänelle 30 ja videolle 60), joten se on paljon tyypillistä ajoa suurempi. Syöte, jonka enimmäishinta ylittäisi mallin ajo­kohtaisen rajan (esimerkiksi hyvin pitkä teksti), hylätään virheellä 422 invalid_input:

1. Hintalaskelma palauttaa enimmäishinnan kentässä credits (sekä kentät hold ja typical, joka kuvaa tavallista ajoa). Kun ajo alkaa, enimmäishinta vähennetään API-saldosta, ja saldon sekä avaimen budjetin on katettava se.
2. Kun ajo onnistuu, pyyntö selvitetään mallin ilmoittaman käytön mukaan: käyttö × käyttöhinta, pyöristettynä ylöspäin kokonaiseksi API-krediitiksi. Loppuosa enimmäishinnasta hyvitetään automaattisesti kerran API-saldon refund-rivin kautta.
3. Ajo ei koskaan maksa enimmäishintaa enempää, vaikka käyttö sitä edellyttäisi. Epäonnistunut tai peruutettu ajo hyvitetään kokonaan, kuten aina.

Useimmat ajot maksavat paljon enimmäishintaa vähemmän; mallin sivulla näytetään rakennustyökalun syötteelle "Enintään $X ajoa kohti" ja tyypilliselle ajolle (luettelossa "alkaen"). Harvoilla käsittelyajan mukaan laskutettavilla malleilla käyttö on mallin käsittelyaika (merkitty 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"
}

Ajon jälkeen pyynnön cost näyttää pidätetyn summan ja käytön hinnan:

{
  "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 on ajon hinta. settled.status on pending tuloksen ja selvityksen välisen ajan ja no_usage siinä harvinaisessa tapauksessa, ettei malli ilmoittanut käytöstä lainkaan (tällöin enimmäishinta jää hinnaksi).

Hintalaskelma ennen ajoa#

POST https://api.doitong.com/v1/quote/{model_id} ottaa täsmälleen rungon, jonka lähettäisit kutsulle run, ja palauttaa kyseisen syötteen hinnan: tarkan hinnan, paitsi käytön mukaan veloitettavalla mallilla enimmäishinnan, jonka ajo voi maksaa. Avainta ei tarvita eikä kutsu maksa mitään:

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

Avaimen kanssa hintalaskelma palauttaa lisäksi balance_credits- ja balance_usd-kentät (API-saldosi), kentät affordable ja key_budget_remaining. Lisää ?currency=rub, jos haluat rub-määrän.

Hintaobjektit#

Jokaisella API:n hinnalla on sama rakenne:

• mallit: 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" } — lisäksi rub, rub_display ja from_rub Venäjällä tai parametrilla ?currency=rub;
• pyynnöt: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (API-krediittiä; käytön mukaan veloitettava pyyntö sisältää lisäksi kentät mode, held, typical ja settled, katso Käytön mukaan veloitettavat);
• tili: GET https://api.doitong.com/v1/account palauttaa kentän credits (API-saldo), objektin balance: { "credits", "usd" } ja kentän storage (tiedostojen tallennustilan hinta, käyttö ja kuukausiarvio).

Hyvitykset#

• Virheellisestä pyynnöstä (mikä tahansa 4xx ennen ajon alkamista) ei koskaan veloiteta.
• Tilaan failed päättyvä pyyntö (myös timeout) hyvitetään kokonaan API-saldoon automaattisesti.
• Pyyntö, jonka peruutat ennen sen alkamista, hyvitetään kokonaan. Kun malli on alkanut tuottaa tulosta, peruutus on vain pyyntö: jos malli valmistuu, tulos toimitetaan ja veloitetaan.
• Onnistuneesta metered-pyynnöstä palautetaan sen enimmäishinnan käyttämättä jäänyt osa.

Pyyntöobjekti näyttää kaikki tiedot: cost.credits, cost.charged ja cost.refunded.

Tiedostojen tallennus#

Tulostetiedostot säilytetään tallennustilassamme. Valitset tallennuksen keston tilillä tai ajoa kohti (?storage=):

Pysyvästä tallennuksesta veloitetaan kerran päivässä API-saldosta: säilytetyt gigatavut × kuukausihinta ÷ kuukauden päivien määrä, tilikirjan storage-tyyppisinä riveinä. API-krediitin murto-osat siirtyvät seuraavaan päivään, joten kuukauden kokonaishinnaksi tulee täsmälleen gigatavujen määrä × 100 API-krediittiä (1 GB = 1024³ tavua; 10 GB:n säilytys kuukauden ajan maksaa 1 000 API-krediittiä). Saldo ei koskaan mene alle nollan: jos maksuun ei ole varaa, kyseiseltä päivältä ei veloiteta, saat sähköpostiviestin ja sinulla on 30 päivää aikaa tehdä saldon lisäys, ennen kuin säilytetyt tiedostot muuttuvat väliaikaisiksi ja ne poistetaan 7 päivää myöhemmin. Lisätietoja: Tiedostot.

Nykyiset hinnat#

Nämä ovat suositellut mallit. Kaikki 1 496 mallia ja niiden hinnat ovat malliluettelossa ja komennossa GET /models (avainta ei tarvita).

Saldon lisäys#

Lisää rahaa API-saldoon osoitteessa https://doitong.com/developers/dashboard#balance. Kun saldo on liian pieni, ajo palauttaa virheen 402 insufficient_credits ja kentän top_up_url. Jokaiselle API-avaimelle voi myös määrittää oman budjetin API-krediitteinä (katso Todennus).