Prezzi

Ogni modello costa esattamente quanto addebita il suo produttore, in dollari statunitensi. Paghi dal tuo saldo API, conteggiato in crediti API: 1000 crediti API = 1 $. Il saldo API è indipendente e separato dai crediti delle app Doitong. Non ci sono piani, minimi o commissioni per modello: una chiamata costa il suo prezzo, addebitato dal saldo API quando la richiesta viene accettata.

In Russia (doitong.ru, api.doitong.ru o ?currency=rub) i prezzi sono mostrati anche in rubli: prezzo USD × tasso USD/RUB × 1,3.

Unità#

Ogni modello ha un'unità di fatturazione, mostrata nella sua pagina e in GET https://api.doitong.ru/v1/models/{model_id}:

Prezzo = quantità × crediti API per unità, arrotondato per eccesso a un credito API intero (0,001 $), mai inferiore a 1. Le unità molto economiche possono avere un prezzo frazionario per unità (0.4 crediti API al secondo); viene arrotondato solo il totale della chiamata.

Alcuni modelli applicano una tariffa diversa in base all'input: un video con audio costa più di uno senza, il 4K costa più dell'1K e così via. Queste regole sono elencate nella pagina di ogni modello. Un parametro omesso conta come valore predefinito, quindi il prezzo mostrato per un input è il prezzo che paghi.

Prezzi esatti, misurati, stimati e basati sull'utilizzo#

Ogni prezzo ha una mode:

• exact: il prezzo viene calcolato dall'input (secondi, immagini, megapixel, caratteri, passaggi oppure un prezzo fisso per video o chiamata).
• measured: il prezzo segue i file inviati: la durata di un video o audio di input, le dimensioni di un'immagine di input, la frequenza dei fotogrammi o il numero di fotogrammi di un video. Upscaler, sincronizzazione labiale, video-to-video, trascrizione e strumenti audio vengono prezzati in questo modo. Prima dell'esecuzione l'API legge durata, risoluzione e frequenza dei fotogrammi del file (lo fa anche il preventivo), quindi il preventivo è esattamente ciò che l'esecuzione addebita. La pagina del modello indica per cosa paghi ("Prezzo al secondo del tuo video di input") e il relativo calcolatore usa i dati del tuo file. Un file che non può essere letto viene rifiutato con unmeasurable_input e non viene addebitato nulla.
• estimate: il costo del modello dipende da qualcosa che l'input non può indicare in anticipo (token, tempo di calcolo). Un modello di questo tipo applica un prezzo stimato fisso per esecuzione (per immagine di output quando ha un conteggio di immagini), impostato sul costo medio delle esecuzioni reali di quel modello. Conosci comunque il prezzo prima dell'esecuzione: il preventivo è ciò che paghi.
• metered: il modello viene addebitato in base all'utilizzo effettivo, che solo l'esecuzione può conoscere: i token che un modello linguistico o visivo legge e scrive, i secondi di parlato generati da un modello vocale o il tempo di elaborazione del modello. Vedi Addebito in base all'utilizzo qui sotto.

Le pagine dei modelli riportano "Prezzo per esecuzione", "Prezzo al secondo del tuo video di input" (e simili), "Prezzo stimato per esecuzione" oppure "Addebito in base all'utilizzo"; GET https://api.doitong.ru/v1/models?mode=measured, ?mode=estimate e ?mode=metered li elencano.

Addebito in base all'utilizzo#

Un modello metered ha un prezzo basato sull'utilizzo ("$0.01 per 1000 token", "$0.002 al secondo di audio generato", "$0.00111 al secondo di tempo di elaborazione") e un massimo per esecuzione: il costo massimo dell'esecuzione, in base a ciò che indica la richiesta (max_tokens, la lunghezza del testo, la risoluzione, il numero di output) e ai limiti pubblicati dal modello. Non dipende mai dal contenuto di un file dietro un URL. Per un modello fatturato in base al tempo di elaborazione o alla durata di una sessione vocale, il massimo è la durata più lunga per cui può essere eseguita una richiesta (15 minuti per le immagini, 30 per l'audio, 60 per il video), quindi è molto superiore a un'esecuzione tipica. Un input il cui massimo supererebbe il limite per esecuzione del modello (un testo molto lungo) viene rifiutato con 422 invalid_input:

1. Il preventivo restituisce il massimo come credits (con hold e typical, un'esecuzione abituale). Quando l'esecuzione inizia, il massimo viene addebitato dal saldo API, che deve essere coperto dal saldo e dal budget della chiave.
2. Quando l'esecuzione riesce, la richiesta viene regolata sull'utilizzo comunicato dal modello: utilizzo × prezzo basato sull'utilizzo, arrotondato per eccesso a un credito API intero. Il resto del massimo viene rimborsato automaticamente, una sola volta, come riga refund del saldo API.
3. Un'esecuzione non costa mai più del suo massimo, anche se il suo utilizzo lo supererebbe. Un'esecuzione fallita o annullata viene rimborsata interamente, come sempre.

La maggior parte delle esecuzioni costa molto meno del massimo; la pagina del modello mostra "Fino a $X per esecuzione" per l'input del builder e l'esecuzione tipica ("da" nel catalogo). Per i pochi modelli fatturati in base al tempo di elaborazione, l'utilizzo è il tempo di elaborazione del modello (contrassegnato come 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"
}

Dopo l'esecuzione, cost della richiesta mostra quanto è stato trattenuto e a quanto ammonta l'utilizzo:

{
  "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 è il costo dell'esecuzione. settled.status è pending per il periodo tra il risultato e la regolazione e no_usage nel raro caso in cui il modello non abbia comunicato alcun utilizzo (in tal caso il massimo resta il prezzo).

Preventivo prima dell'esecuzione#

POST https://api.doitong.ru/v1/quote/{model_id} accetta esattamente il corpo che invieresti a run e restituisce il prezzo di quell'input: il prezzo esatto, tranne per un modello con addebito in base all'utilizzo, per il quale restituisce il costo massimo dell'esecuzione. Non richiede una chiave e non costa nulla:

curl -X POST "https://api.doitong.ru/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": []
}

Con una chiave, il preventivo restituisce anche balance_credits e balance_usd (il tuo saldo API), affordable e key_budget_remaining. Aggiungi ?currency=rub per un importo in rub.

Oggetti prezzo#

Ogni prezzo nell'API ha la stessa struttura:

• 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" } — oltre a rub, rub_display e from_rub in Russia o con ?currency=rub;
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (crediti API; una richiesta metered aggiunge mode, held, typical e settled, vedi Addebito in base all'utilizzo);
• account: GET https://api.doitong.ru/v1/account restituisce credits (il saldo API), balance: { "credits", "usd" } e storage (prezzo dell'archiviazione dei file, utilizzo e stima mensile).

Rimborsi#

• Una richiesta non valida (qualsiasi 4xx prima dell'inizio dell'esecuzione) non viene mai addebitata.
• Una richiesta che termina con failed (incluso timeout) viene rimborsata interamente e automaticamente sul saldo API.
• Una richiesta annullata prima dell'inizio viene rimborsata interamente. Una volta che il modello sta generando, l'annullamento è solo una richiesta: se il modello termina, il risultato viene consegnato e addebitato.
• Una richiesta metered completata riceve indietro la parte del massimo non utilizzata.

L'oggetto della richiesta mostra tutto: cost.credits, cost.charged e cost.refunded.

Archiviazione dei file#

I file di output vengono conservati nella nostra archiviazione. Scegli tu, nell'account o per ogni esecuzione (?storage=):

L'archiviazione permanente viene addebitata una volta al giorno dal saldo API: GB conservati × prezzo mensile ÷ giorni del mese, come righe di registro di tipo storage. Le frazioni di un credito API vengono trasferite al giorno successivo, quindi in un mese il totale è esattamente GB × 100 crediti API (1 GB = 1024³ byte; 10 GB conservati per un mese costano 1000 crediti API). Il saldo non scende mai sotto zero: quando non è possibile pagare, quel giorno non viene addebitato, ricevi un'email e hai 30 giorni per effettuare una ricarica prima che i file conservati diventino temporanei e vengano eliminati 7 giorni dopo. Dettagli: File.

Prezzi attuali#

Questi sono i modelli in evidenza. Tutti i 1496 modelli e i relativi prezzi sono disponibili nel catalogo dei modelli e in GET /models (non è necessaria alcuna chiave).

Ricarica#

Aggiungi denaro al saldo API su https://doitong.ru/developers/dashboard#balance. Quando il saldo è troppo basso, un'esecuzione risponde con 402 insufficient_credits e un top_up_url. Ogni chiave API può anche avere un budget proprio in crediti API (vedi Autenticazione).