Priser

Hver model koster præcis det, som modellens producent opkræver for den, i amerikanske dollars. Du betaler fra din API-saldo, som tælles i API-kreditter: 1.000 API-kreditter = 1 $. API-saldoen er sin egen saldo, adskilt fra Doitong-appsnes kreditter. Der er ingen abonnementer, minimumsbeløb eller gebyrer pr. model: et kald koster sin pris, som trækkes fra API-saldoen, når anmodningen accepteres.

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

Enheder#

Hver model har én faktureringsenhed, som vises på dens side og i GET https://api.doitong.com/v1/models/{model_id}:

Pris = mængde × API-kreditter pr. enhed, rundet op til en hel API-kredit (0,001 $), aldrig mindre end 1. Meget billige enheder kan have en brøkpris pr. enhed (0.4 API-kreditter pr. sekund); kun totalen for et kald rundes.

Nogle modeller opkræver en anden sats afhængigt af inputtet: video med lyd koster mere end uden, 4K koster mere end 1K osv. Disse regler står på hver modelside. En parameter, du udelader, tæller som dens standardværdi, så den pris, du ser for et input, er den pris, du betaler.

Priser baseret på præcise, målte, estimerede og forbrugsbaserede værdier#

Alle priser har en mode:

• exact: Prisen beregnes ud fra dit input (sekunder, billeder, megapixel, tegn, trin eller én fast pris pr. video eller kald).
• measured: Prisen følger de filer, du sender: længden af en inputvideo eller -lyd, størrelsen af et inputbillede, billedhastigheden eller antallet af frames i en video. Opskalering, lip sync, video-til-video, transskription og lydværktøjer prissættes på denne måde. Før kørslen læser API'et filens længde, opløsning og billedhastighed (tilbuddet gør det samme), så tilbuddet er præcis det, som kørslen opkræver. Modellsiden angiver, hvad du betaler for ("Pris pr. sekund af din inputvideo"), og beregneren bruger tallene fra din fil. En fil, der ikke kan læses, afvises med unmeasurable_input, og der opkræves ikke noget.
• estimate: Modellens egen pris afhænger af noget, som inputtet ikke kan fortælle på forhånd (tokens, beregningstid). En sådan model opkræver en fast estimeret pris pr. kørsel (pr. outputbillede, når den har et billedantal), fastsat ud fra den gennemsnitlige pris for faktiske kørsler med modellen. Du kender stadig prisen, før du kører: tilbuddet er det, du betaler.
• metered: Modellen opkræves efter det faktiske forbrug, som kun selve kørslen kender: de tokens, en sprog- eller visionsmodel læser og skriver, de sekunder tale, som en stemmemodel genererer, eller modellens behandlingstid. Se Opkrævet efter forbrug nedenfor.

Modellsider angiver "Pris pr. kørsel", "Pris pr. sekund af din inputvideo" (og lignende), "Estimeret pris pr. kørsel" eller "Opkrævet efter forbrug"; GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate og ?mode=metered viser dem.

Opkrævet efter forbrug#

En metered-model har en forbrugspris ("$0.01 pr. 1000 tokens", "$0.002 pr. sekund genereret lyd", "$0.00111 pr. sekund behandlingstid") og et maksimum pr. kørsel: det højeste, kørslen kan koste, baseret på hvad din anmodning angiver (max_tokens, længden af din tekst, opløsningen, antallet af outputs) og modellens offentliggjorte grænser. Det afhænger aldrig af indholdet af en fil bag en URL. For en model, der faktureres efter behandlingstid eller længden af en stemme- session, er maksimum den længste tid, en anmodning må køre (15 minutter for billeder, 30 for lyd, 60 for video), så det er langt over en typisk kørsel. Et input, hvis maksimum ville overstige modellens grænse pr. kørsel (en meget lang tekst), afvises med 422 invalid_input:

1. Tilbuddet returnerer dette maksimum som credits (med hold og typical, en typisk kørsel). Når kørslen starter, trækkes maksimum fra API-saldoen, og det er det, saldoen og dit nøglebudget skal dække.
2. Når kørslen lykkes, afregnes anmodningen efter det forbrug, modellen rapporterer: forbrug × forbrugsprisen, rundet op til en hel API-kredit. Resten af maksimum tilbagebetales automatisk, én gang, som en refund-post på din API-saldo.
3. En kørsel koster aldrig mere end sit maksimum, heller ikke hvis forbruget ville gøre det. En mislykket eller annulleret kørsel tilbagebetales fuldt ud, som altid.

De fleste kørsler koster langt mindre end maksimum; modellsiden viser "Op til $X pr. kørsel" for builderens input og den typiske kørsel ("fra" i kataloget). For de få modeller, der faktureres efter behandlingstid, er forbruget modellens behandlingstid (markeret 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"
}

Efter kørslen viser anmodningens cost, hvad der blev reserveret, og hvad forbruget 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, kørslen kostede. settled.status er pending i øjeblikket mellem resultatet og afregningen og no_usage i det sjældne tilfælde, hvor modellen slet ikke rapporterede noget forbrug (så står maksimum som prisen).

Få et tilbud før kørsel#

POST https://api.doitong.com/v1/quote/{model_id} tager præcis den brødtekst, du ville sende til run, og returnerer prisen for det input: den præcise pris, bortset fra en model opkrævet efter forbrug, hvor det er det højeste, kørslen kan koste. Det kræver ingen nøgle 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øgle returnerer tilbuddet også balance_credits og balance_usd (din API-saldo), affordable og key_budget_remaining. Tilføj ?currency=rub for et rub-beløb.

Prisobjekter#

Alle priser i API'et har samme struktur:

• 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" } — plus rub, rub_display og from_rub i Rusland eller med ?currency=rub;
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (API-kreditter; en metered-anmodning tilføjer mode, held, typical og settled, se Opkrævet efter forbrug);
• account: GET https://api.doitong.com/v1/account returnerer credits (API-saldoen), balance: { "credits", "usd" } og storage (pris, forbrug og månedligt estimat for fillagring).

Tilbagebetalinger#

• En ugyldig anmodning (enhver 4xx, før kørslen starter) opkræves aldrig.
• En anmodning, der ender som failed (inklusive timeout), tilbagebetales fuldt ud til API-saldoen automatisk.
• En anmodning, du annullerer, før den starter, tilbagebetales fuldt ud. Når modellen er i gang med at generere, er en annullering kun en anmodning: Hvis modellen bliver færdig, leveres resultatet, og der opkræves betaling.
• En metered-anmodning, der lykkes, får den del af sit maksimum tilbage, som den ikke brugte.

Anmodningsobjektet viser det hele: cost.credits, cost.charged og cost.refunded.

Fillagring#

Outputfiler opbevares på vores lager. Du vælger det på kontoen eller pr. kørsel (?storage=):

Permanent lagring opkræves én gang om dagen fra API-saldoen: gemte GB × månedsprisen ÷ antal dage i måneden, som poster i finansbogen af typen storage. Brøkdele af en API-kredit overføres til næste dag, så en måned samlet set bliver præcis GB × 100 API-kreditter (1 GB = 1024³ bytes; 10 GB gemt i en måned koster 1.000 API-kreditter). Saldoen kommer aldrig under nul: Når der ikke er nok til at betale, opkræves den dag ikke, du får en e-mail, og du har 30 dage til optankning, før de gemte filer bliver midlertidige og slettes 7 dage senere. Detaljer: Filer.

Aktuelle priser#

Dette er de fremhævede modeller. Alle 1.496 modeller og deres priser findes i modelkataloget og i GET /models (ingen nøgle nødvendig).

Optankning#

Tilføj penge til API-saldoen på https://doitong.com/developers/dashboard#balance. Når saldoen er for lav, svarer en kørsel 402 insufficient_credits med en top_up_url. Hver API-nøgle kan også begrænses med sit eget budget i API-kreditter (se Godkendelse).