Priser

Hver modell koster nøyaktig det modellens leverandør tar for den, i amerikanske dollar. Du betaler fra API-saldoen, som telles i API-kreditter: 1 000 API-kreditter = 1 $. API-saldoen er en egen saldo, separat fra kredittene i Doitong-appene. Det finnes ingen abonnementer, minimumsbeløp eller modellavgifter: et kall koster prisen sin, trukket fra API-saldoen når forespørselen godtas.

I Russland (doitong.ru, api.doitong.ru eller ?currency=rub) vises prisene også i rubler: USD-prisen × USD/RUB-kursen × 1,3.

Enheter#

Hver modell har én faktureringsenhet, vist på siden dens og i GET https://api.doitong.com/v1/models/{model_id}:

Pris = mengde × API-kreditter per enhet, rundet opp til en hel API-kreditt (0,001 $), aldri mindre enn 1. Svært billige enheter kan ha en brøkpris per enhet (0.4 API-kreditter per sekund); bare totalen for et kall rundes av.

Noen modeller tar en annen pris avhengig av inndataene: video med lyd koster mer enn uten, 4K koster mer enn 1K og så videre. Disse reglene listes på hver modellside. En parameter du utelater, regnes som standardverdien, så prisen du ser for en inndata, er prisen du betaler.

Eksakte, målte, estimerte og bruksbaserte priser#

Alle priser har en mode:

• exact: Prisen beregnes fra inndataene dine (sekunder, bilder, megapiksler, tegn, steg eller én fast pris per video eller kall).
• measured: Prisen følger filene du sender: lengden på en inndatavideo eller -lyd, størrelsen på et inndatabilde, bildehastigheten eller antallet bilder i en video. Oppskalerere, leppesynkronisering, video-til-video, transkripsjon og lydverktøy prises slik. Før kjøringen leser API-et filens lengde, oppløsning og bildehastighet (tilbudet gjør det samme), så tilbudet er nøyaktig det kjøringen belaster. Modellens side sier hva du betaler for ("Pris per sekund av inndatavideoen din"), og kalkulatoren bruker filens tall. En fil som ikke kan leses, avvises med unmeasurable_input, og ingenting belastes.
• estimate: Modellens egen kostnad avhenger av noe inndataene ikke kan fortelle på forhånd (token, beregningstid). En slik modell tar en fast estimert pris per kjøring (per utgående bilde når den har et bildeantall), satt ut fra gjennomsnittskostnaden for faktiske kjøringer av modellen. Du kjenner fortsatt prisen før du kjører: tilbudet er det du betaler.
• metered: Modellen belastes etter faktisk bruk, som bare selve kjøringen kjenner: tokenene en språk- eller synsmodell leser og skriver, sekundene med tale en stemmemodell genererer, eller modellens behandlingstid. Se Belastet etter bruk nedenfor.

Modellsidene sier "Pris per kjøring", "Pris per sekund av inndatavideoen din" (og tilsvarende), "Estimert pris per kjøring" eller "Belastet etter bruk"; GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate og ?mode=metered viser dem.

Belastet etter bruk#

En metered-modell har en brukspris ("$0.01 per 1000 token", "$0.002 per sekund med generert lyd", "$0.00111 per sekund behandlingstid") og en maksimumspris per kjøring: det meste kjøringen kan koste, basert på det forespørselen din sier (max_tokens, lengden på teksten din, oppløsningen, antallet utdata) og modellens publiserte grenser. Den avhenger aldri av innholdet i en fil bak en URL. For en modell som faktureres etter behandlingstid eller lengden på en stemmeøkt, er maksimumsprisen den lengste tiden en forespørsel kan kjøre (15 minutter for bilder, 30 for lyd, 60 for video), så den ligger langt over en typisk kjøring. En inndata der maksimumsprisen ville vært over modellens grense per kjøring (en svært lang tekst), avvises med 422 invalid_input:

1. Tilbudet returnerer maksimumsprisen som credits (med hold og typical, en vanlig kjøring). Når kjøringen starter, trekkes maksimumsprisen fra API-saldoen, og det er dette saldoen og nøkkelbudsjettet må dekke.
2. Når kjøringen lykkes, gjøres opp forespørselen etter bruken modellen rapporterer: bruk × brukspris, rundet opp til en hel API-kreditt. Resten av maksimumsprisen betales automatisk tilbake, én gang, som en refund-rad på API-saldoen.
3. En kjøring koster aldri mer enn maksimumsprisen, selv om bruken skulle tilsi det. En mislykket eller avbrutt kjøring får alltid full tilbakebetaling.

De fleste kjøringer koster langt mindre enn maksimumsprisen; modellens side viser "Opptil $X per kjøring" for byggerens inndata og den typiske kjøringen ("fra" i katalogen). For de få modellene som faktureres etter behandlingstid, er bruken modellens behandlingstid (merket 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"
}

Etter kjøringen viser forespørselens cost hva som ble holdt av og hva bruken endte på:

{
  "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 er det kjøringen kostet. settled.status er pending i øyeblikket mellom resultatet og oppgjøret, og no_usage i det sjeldne tilfellet der modellen ikke rapporterte noe bruk i det hele tatt (da gjelder maksimumsprisen som pris).

Få et tilbud før kjøring#

POST https://api.doitong.com/v1/quote/{model_id} tar nøyaktig brødteksten du ville sendt til run og returnerer prisen for disse inndataene: den eksakte prisen, bortsett fra for en modell belastet etter bruk, der det er det meste kjøringen kan koste. Den trenger ingen nøkkel og koster ingenting:

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

Med en nøkkel returnerer tilbudet også balance_credits og balance_usd (API-saldoen din), affordable og key_budget_remaining. Legg til ?currency=rub for et rub-beløp.

Prisobjekter#

Alle priser i API-et har samme form:

• modeller: 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" } — i tillegg til rub, rub_display og from_rub i Russland eller med ?currency=rub;
• forespørsler: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (API-kreditter; en metered-forespørsel legger til mode, held, typical og settled, se Belastet etter bruk);
• konto: GET https://api.doitong.com/v1/account returnerer credits (API-saldoen), balance: { "credits", "usd" } og storage (pris, bruk og månedlig estimat for fillagring).

Tilbakebetalinger#

• En ugyldig forespørsel (hvilken som helst 4xx før kjøringen starter) belastes aldri.
• En forespørsel som ender som failed (inkludert timeout) får full tilbakebetaling til API-saldoen automatisk.
• En forespørsel du avbryter før den starter, får full tilbakebetaling. Når modellen først genererer, er en avbrytning bare en forespørsel: hvis modellen blir ferdig, leveres resultatet og belastes.
• En metered-forespørsel som lykkes, får tilbake den delen av maksimumsprisen som ikke ble brukt.

Forespørselsobjektet viser alt: cost.credits, cost.charged og cost.refunded.

Fillagring#

Utdatafiler oppbevares i lagringen vår. Du velger dette i kontoen eller per kjøring (?storage=):

Permanent lagring belastes én gang daglig fra API-saldoen: lagrede GB × månedsprisen ÷ antallet dager i måneden, som ledger-rader av typen storage. Brøkdeler av en API-kreditt tas med til neste dag, slik at en måned utgjør nøyaktig GB × 100 API-kreditter (1 GB = 1024³ byte; 10 GB lagret i én måned koster 1 000 API-kreditter). Saldoen går aldri under null: når den ikke kan betale, belastes ikke den dagen, du får en e-post, og du har 30 dager til å gjøre et påfyll før de lagrede filene blir midlertidige og slettes 7 dager senere. Detaljer: Filer.

Gjeldende priser#

Dette er de fremhevede modellene. Alle 1 496 modellene og prisene deres finnes i modellkatalogen og i GET /models (ingen nøkkel kreves).

Gjør et påfyll#

Legg til penger på API-saldoen på https://doitong.com/developers/dashboard#balance. Når saldoen er for lav, svarer en kjøring med 402 insufficient_credits og en top_up_url. Hver API-nøkkel kan også begrenses med sitt eget budsjett i API-kreditter (se Autentisering).