# 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.com/v1/models/{model_id}`: | Unità | Quantità | |---|---| | `second` | Secondi di video o audio di output (`duration`) | | `image` | Immagini generate (`num_images`) | | `megapixel` | Larghezza × altezza dell'output, in megapixel (1 MP = 1024 × 1024 pixel) | | `video` | Un video generato | | `request` | Una chiamata | | `1000_characters` | Caratteri del testo di input, per 1000 | | `step` | Passaggi di addestramento | 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](#metered) 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.com/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`). ```json 200 OK · preventivo di un modello metered { "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: ```json { "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.com/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](#metered), per il quale restituisce il costo massimo dell'esecuzione. Non richiede una chiave e non costa nulla: ```bash 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}' ``` ```json 200 OK · preventivo { "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`. > [!TIP] > **Il preventivo è l'addebito.** La stessa funzione calcola entrambi, quindi un'esecuzione con questo input costa esattamente `credits`. > L'unica eccezione è un modello [con addebito in base all'utilizzo](#metered) (`mode: metered`): in quel caso `credits` è il costo massimo dell'esecuzione, > addebitato all'avvio, e la parte non utilizzata viene rimborsata dopo l'esecuzione. ## 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](#metered)); - account: `GET https://api.doitong.com/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=`): | | Conservazione | Prezzo | |---|---|---| | Per sempre (`permanent`, predefinito) | Finché non li elimini | 100 crediti API (0,10 $) per GB al mese | | 7 giorni (`temporary`) | 7 giorni | Gratis | 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](https://doitong.com/developers/docs/files#storage). ## Prezzi attuali | Modello | ID | Prezzo | Da | |---|---|---|---| | [FLUX.1 \[dev\]](https://doitong.com/developers/models/flux/dev) | `flux/dev` | 0,025 $ / megapixel | 0,025 $ (25 crediti API) | | [FLUX.1 \[schnell\]](https://doitong.com/developers/models/flux/schnell) | `flux/schnell` | 0,003 $ / megapixel | 0,003 $ (3 crediti API) | | [FLUX.2 \[dev\]](https://doitong.com/developers/models/flux-2) | `flux-2` | 0,012 $ / megapixel | 0,012 $ (12 crediti API) | | [FLUX.2 \[pro\]](https://doitong.com/developers/models/flux-2-pro) | `flux-2-pro` | 0,015 $ / megapixel di immagine in output | 0,015 $ (15 crediti API) | | [GPT Image 2.5 Text to Image](https://doitong.com/developers/models/openai/gpt-image-2.5/flare/text-to-image) | `openai/gpt-image-2.5/flare/text-to-image` | a partire da 0,008 $ / immagine | 0,008 $ (8 crediti API) | | [Ideogram V4.5](https://doitong.com/developers/models/ideogram/v4.5) | `ideogram/v4.5` | a partire da 0,03 $ / immagine | 0,03 $ (30 crediti API) | | [Nano Banana 2](https://doitong.com/developers/models/nano-banana-2) | `nano-banana-2` | a partire da 0,06 $ / immagine | 0,06 $ (60 crediti API) | | [Nano Banana Pro](https://doitong.com/developers/models/nano-banana-pro) | `nano-banana-pro` | a partire da 0,15 $ / immagine | 0,15 $ (150 crediti API) | | [Qwen Image 3 Text to Image](https://doitong.com/developers/models/alibaba/qwen-image-3/text-to-image) | `alibaba/qwen-image-3/text-to-image` | a partire da 0,04 $ / immagine | 0,04 $ (40 crediti API) | | [Recraft V4.1 Text to Image](https://doitong.com/developers/models/recraft/v4.1/text-to-image) | `recraft/v4.1/text-to-image` | 0,035 $ / immagine | 0,035 $ (35 crediti API) | | [Seedream 5.0 Pro Text to Image](https://doitong.com/developers/models/bytedance/seedream/v5/pro/text-to-image) | `bytedance/seedream/v5/pro/text-to-image` | a partire da 0,068 $ | 0,068 $ (68 crediti API) | | [FLUX.1 Kontext \[pro\]](https://doitong.com/developers/models/flux-pro/kontext) | `flux-pro/kontext` | 0,04 $ / immagine | 0,04 $ (40 crediti API) | | [Nano Banana 2 Edit](https://doitong.com/developers/models/nano-banana-2/edit) | `nano-banana-2/edit` | a partire da 0,06 $ / immagine | 0,06 $ (60 crediti API) | | [Nano Banana Pro Edit](https://doitong.com/developers/models/nano-banana-pro/edit) | `nano-banana-pro/edit` | a partire da 0,15 $ / immagine | 0,15 $ (150 crediti API) | | [Qwen Image 3 Edit](https://doitong.com/developers/models/alibaba/qwen-image-3/edit) | `alibaba/qwen-image-3/edit` | a partire da 0,04 $ / immagine | 0,04 $ (40 crediti API) | | [FLUX 3 Max Text to Video](https://doitong.com/developers/models/blackforestlabs/flux-3-max/text-to-video) | `blackforestlabs/flux-3-max/text-to-video` | a partire da 0,0425 $ / secondo di video in output | 0,043 $ (43 crediti API) | | [Grok Imagine Video 1.5 Text to Video](https://doitong.com/developers/models/xai/grok-imagine-video/v1.5/text-to-video) | `xai/grok-imagine-video/v1.5/text-to-video` | a partire da 0,08 $ / secondo | 0,48 $ (480 crediti API) | | [Kling 3.0 Pro Text to Video](https://doitong.com/developers/models/kling-video/v3/pro/text-to-video) | `kling-video/v3/pro/text-to-video` | a partire da 0,112 $ / secondo | 0,56 $ (560 crediti API) | | [LTX 2.5 Pro Text to Video](https://doitong.com/developers/models/lightricks/ltx-2.5/text-to-video/pro) | `lightricks/ltx-2.5/text-to-video/pro` | a partire da 0,12 $ / secondo | 0,72 $ (720 crediti API) | | [MiniMax H3 Text to Video](https://doitong.com/developers/models/minimax/h3/text-to-video) | `minimax/h3/text-to-video` | a partire da 0,05 $ / secondo | 0,25 $ (250 crediti API) | | [Seedance 2.0 Fast Text to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/text-to-video) | `bytedance/seedance-2.0/fast/text-to-video` | a partire da 0,113 $ / secondo | 0,452 $ (452 crediti API) | | [Seedance 2.0 Text to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/text-to-video) | `bytedance/seedance-2.0/text-to-video` | a partire da 0,141 $ / secondo | 0,564 $ (564 crediti API) | | [Veo 3.1](https://doitong.com/developers/models/veo3.1) | `veo3.1` | a partire da 0,20 $ / secondo | 1,60 $ (1600 crediti API) | | [Veo 3.1 Fast](https://doitong.com/developers/models/veo3.1/fast) | `veo3.1/fast` | a partire da 0,10 $ / secondo | 0,80 $ (800 crediti API) | | [Wan 3.0 Text to Video](https://doitong.com/developers/models/alibaba/wan-3.0/text-to-video) | `alibaba/wan-3.0/text-to-video` | a partire da 0,05 $ / secondo | 0,25 $ (250 crediti API) | | [FLUX 3 Max Image to Video](https://doitong.com/developers/models/blackforestlabs/flux-3-max/image-to-video) | `blackforestlabs/flux-3-max/image-to-video` | a partire da 0,0425 $ / secondo di video in output | 0,043 $ (43 crediti API) | | [Grok Imagine Video 1.5 Image to Video](https://doitong.com/developers/models/xai/grok-imagine-video/v1.5/image-to-video) | `xai/grok-imagine-video/v1.5/image-to-video` | a partire da 0,082 $ / secondo | 0,492 $ (492 crediti API) | | [Kling 3.0 Pro Image to Video](https://doitong.com/developers/models/kling-video/v3/pro/image-to-video) | `kling-video/v3/pro/image-to-video` | a partire da 0,112 $ / secondo | 0,56 $ (560 crediti API) | | [LTX 2.5 Pro Image to Video](https://doitong.com/developers/models/lightricks/ltx-2.5/image-to-video/pro) | `lightricks/ltx-2.5/image-to-video/pro` | a partire da 0,12 $ / secondo | 0,72 $ (720 crediti API) | | [MiniMax H3 Image to Video](https://doitong.com/developers/models/minimax/h3/image-to-video) | `minimax/h3/image-to-video` | a partire da 0,05 $ / secondo | 0,25 $ (250 crediti API) | | [Seedance 2.0 Fast Image to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/image-to-video) | `bytedance/seedance-2.0/fast/image-to-video` | a partire da 0,113 $ / secondo | 0,452 $ (452 crediti API) | | [Seedance 2.0 Image to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/image-to-video) | `bytedance/seedance-2.0/image-to-video` | a partire da 0,141 $ / secondo | 0,564 $ (564 crediti API) | | [Veo 3.1 Fast Image to Video](https://doitong.com/developers/models/veo3.1/fast/image-to-video) | `veo3.1/fast/image-to-video` | a partire da 0,10 $ / secondo | 0,80 $ (800 crediti API) | | [Veo 3.1 Image to Video](https://doitong.com/developers/models/veo3.1/image-to-video) | `veo3.1/image-to-video` | a partire da 0,20 $ / secondo | 1,60 $ (1600 crediti API) | | [Wan 3.0 Image to Video](https://doitong.com/developers/models/alibaba/wan-3.0/image-to-video) | `alibaba/wan-3.0/image-to-video` | a partire da 0,05 $ / secondo | 0,25 $ (250 crediti API) | | [Seedance 2.0 Fast Reference to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/reference-to-video) | `bytedance/seedance-2.0/fast/reference-to-video` | a partire da 0,113 $ / secondo | 0,452 $ (452 crediti API) | | [Seedance 2.0 Reference to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/reference-to-video) | `bytedance/seedance-2.0/reference-to-video` | a partire da 0,141 $ / secondo | 0,564 $ (564 crediti API) | | [Kling AI Avatar 2.0 Pro](https://doitong.com/developers/models/kling-video/ai-avatar/v2/pro) | `kling-video/ai-avatar/v2/pro` | 0,115 $ / secondo di audio in input | 0,115 $ (115 crediti API) | | [Sync Lipsync 3](https://doitong.com/developers/models/sync-lipsync/v3) | `sync-lipsync/v3` | 8,00 $ / minuto di video in output | 8,00 $ (8000 crediti API) | | [VEED Fabric 1.0](https://doitong.com/developers/models/veed/fabric-1.0) | `veed/fabric-1.0` | a partire da 0,08 $ / secondo di audio in input | 0,08 $ (80 crediti API) | | [Topaz Image Upscale](https://doitong.com/developers/models/topaz/upscale/image/precision) | `topaz/upscale/image/precision` | 0,08 $ / 24 megapixel di immagine in output | 0,08 $ (80 crediti API) | | [Topaz Video Upscale](https://doitong.com/developers/models/topaz/upscale/video/precision) | `topaz/upscale/video/precision` | a partire da 0,00667 $ / secondo di video in input | 0,10 $ (100 crediti API) | | [Bria RMBG 2.0](https://doitong.com/developers/models/bria/background/remove) | `bria/background/remove` | a partire da 0,018 $ | 0,018 $ (18 crediti API) | | [Eleven v4 Text to Speech](https://doitong.com/developers/models/elevenlabs/tts/eleven-v4) | `elevenlabs/tts/eleven-v4` | 0,08 $ / 1000 caratteri | 0,08 $ (80 crediti API) | | [MiniMax Speech 2.8 HD](https://doitong.com/developers/models/minimax/speech-2.8-hd) | `minimax/speech-2.8-hd` | 0,10 $ / 1000 caratteri | 0,10 $ (100 crediti API) | | [MiniMax Music 3](https://doitong.com/developers/models/minimax/music-3) | `minimax/music-3` | 0,002 $ / secondo | 0,12 $ (120 crediti API) | | [MMAudio V2](https://doitong.com/developers/models/mmaudio-v2) | `mmaudio-v2` | 0,001 $ / secondo | 0,008 $ (8 crediti API) | Questi sono i modelli in evidenza. Tutti i 1496 modelli e i relativi prezzi sono disponibili nel [catalogo dei modelli](https://doitong.com/developers/models) e in `GET /models` (non è necessaria alcuna chiave). ## Ricarica Aggiungi denaro al saldo API su [https://doitong.com/developers/dashboard#balance](https://doitong.com/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](https://doitong.com/developers/docs/authentication#credit-budgets)).