Guide
Fatturazione e crediti
Crediti prepagati, come viene trattenuto e poi addebitato il costo di una generazione, rimborsi automatici per le attività non riuscite, ricarica automatica e controllo del saldo via API.
CheaperGen è prepagato e a consumo. Aggiungi crediti in dollari statunitensi; ogni generazione viene pagata con quel saldo e ti addebitiamo solo i risultati generati correttamente. Non è necessario un abbonamento: i piani mensili facoltativi aggiungono crediti automaticamente e possono ridurre i prezzi. Non ci sono costi per utente né commissioni di piattaforma.
Crediti#
- Aggiungi crediti in Dashboard → Fatturazione con una carta (per importi molto elevati è disponibile anche il bonifico bancario nella dashboard). I pagamenti vengono elaborati da Stripe e i crediti aggiunti non appena il pagamento va a buon fine.
- I crediti non scadono mai.
- Un unico saldo copre tutti i modelli, l'API e Studio.
- Le ricevute di ogni pagamento sono disponibili nella dashboard. Gli account Enterprise possono scegliere la fatturazione mensile; consulta Enterprise.
- I crediti sono prepagati e non rimborsabili, salvo nei casi previsti dalla legge; consulta i Termini di servizio. Le generazioni non riuscite o annullate vengono sempre rimborsate sul saldo.
Come si paga una generazione#
- Preventivo. Quando invii la richiesta, ne calcoliamo il prezzo in base agli input (risoluzione e durata per i video, dimensioni e numero per le immagini), usando il prezzo pubblico del modello.
- Blocco. L’importo viene subito detratto dal saldo e la generazione entra in coda. Se il saldo è insufficiente, la richiesta restituisce
402 insufficient_balancee non viene addebitato nulla. - Addebito finale. Se la generazione va a buon fine, l’importo riservato diventa l’addebito finale. Se l’utilizzo effettivo differisce dal preventivo, la differenza viene registrata come rettifica.
- Rimborso. Se la generazione non riesce, o la annulli mentre è in coda, l’intero importo riservato viene restituito automaticamente al saldo.
Ogni generazione riporta il proprio costo. Durante l’esecuzione, l’importo è riservato e estimated è true; al completamento, estimated è false:
{
"status": "succeeded",
"cost": {
"amount_usd": 0.4494,
"currency": "usd",
"estimated": false
}
}Unità di fatturazione#
- Video viene tariffato al secondo di video generato alla risoluzione selezionata. Un clip da 10 secondi costa il doppio di uno da 5 secondi.
- Immagini: tariffa per immagine alla dimensione selezionata;
num_images: 4costa quanto quattro immagini. - I modelli Seedance sono tariffati in token video esattamente come nell’API ufficiale:
tokens = seconds × width × height × 24 ÷ 1024. I prezzi sul sito sono convertiti in tariffe al secondo in formato 16:9; le altre proporzioni possono variare leggermente. - I Video di riferimento aggiungono secondi fatturabili nei modelli che li addebitano — consulta qui sotto. Le immagini e l’audio di riferimento non modificano il prezzo.
- I prezzi sono mostrati con un massimo di quattro decimali e arrotondati per eccesso al valore più vicino a $0,0001 per richiesta.
Il listino completo di tutti i modelli e di tutte le fasce è disponibile nella pagina dei prezzi.
Stimare il costo prima dell'avvio#
POST /api/v1/quote/{endpoint} calcola il prezzo di qualsiasi input senza eseguirlo. Non richiede una chiave API e ignora i campi di contenuto come prompt e immagini. Per esempio, Seedance 2.0 Fast con queste impostazioni costa $0,45:
curl -X POST https://cheapergen.com/api/v1/quote/bytedance/seedance-2.0-fast/text-to-video \
-H "Content-Type: application/json" \
-d '{"aspect_ratio":"16:9","resolution":"720p","duration":5}'{
"amount_usd": 0.4494,
"list_usd": 0.6048,
"list_price_source": "official",
"list_price_label": "Official",
"discount_pct": 26,
"available": true,
"currency": "usd"
}amount_usd è l'importo che pagherai, list_usd il prezzo di listino per la stessa richiesta e discount_pct il tuo risparmio in percentuale. list_price_source indica official quando list_usd è il prezzo di listino dello sviluppatore, e reference quando è un altro prezzo usato per il confronto e indicato da list_price_label (per esempio fal API, per un modello il cui sviluppatore non vende un'API internazionale).
Video di riferimento#
Nelle modalità reference-to-video, la durata dei video di riferimento viene fatturata insieme all’output, come nelle API ufficiali:
- Seedance (2.0, 2.0 Fast, 2.0 Mini, 2.5): token = (secondi del video di riferimento + secondi di output) × larghezza × altezza × 24 ÷ 1024, con una tariffa per token input video più bassa; perciò una richiesta con video costa di più in totale, ma meno al secondo.
- Wan 3.0, Wan 3.0 Prime e MiniMax H3: i secondi dei video di riferimento sono fatturati alla stessa tariffa al secondo dell’output.
Quando invii la richiesta, misuriamo sui nostri server ogni file di riferimento — non usiamo mai la durata indicata nella richiesta — e riserviamo l’importo in base alle durate effettive. Il campo cost.reference_video_seconds della generazione indica i secondi conteggiati. Per ogni secondo fatturabile (5 s di riferimento + 5 s di output, 16:9):
| Modello | Fascia | Ufficiale | CheaperGen |
|---|---|---|---|
| Seedance 2.0 | 480p | $0,0411 | |
| Seedance 2.0 | 720p | $0,0883 | |
| Seedance 2.0 | 1080p | $0,2170 | |
| Seedance 2.0 | 4K | $0,4433 | |
| Seedance 2.5 | 480p | $0,0585 | |
| Seedance 2.5 | 720p | $0,1314 | |
| Seedance 2.5 | 1080p | $0,3232 | |
| Seedance 2.0 Fast | 480p | $0,0298 | |
| Seedance 2.0 Fast | 720p | $0,0539 | |
| Seedance 2.0 Mini | 480p | $0,0178 | |
| Seedance 2.0 Mini | 720p | $0,0382 | |
| Wan 3.0 | 480p | $0,0379 | |
| Wan 3.0 | 720p | $0,0757 | |
| Wan 3.0 | 1080p | $0,1513 | |
| Wan 3.0 Prime | 480p | $0,0582 | |
| Wan 3.0 Prime | 720p | $0,1198 | |
| Wan 3.0 Prime | 1080p | $0,2394 | |
| MiniMax H3 | 768P | $0,0570 | |
| MiniMax H3 | 2K | $0,1068 | |
| MiniMax H3 Fast | 480P | $0,0369 | |
| MiniMax H3 Fast | 768P | $0,0546 |
Stimare il costo di una richiesta con video di riferimento#
/quote non scarica i file. Indica le durate previste delle clip in reference_video_durations (e, facoltativamente, reference_audio_durations), in secondi, una per clip. È una stima: /run misura i file effettivi e riserva quell’importo. Playground legge le durate nel browser e fa lo stesso.
curl -X POST https://cheapergen.com/api/v1/quote/bytedance/seedance-2.0/reference-to-video \
-H "Content-Type: application/json" \
-d '{"resolution":"720p","duration":5,"reference_video_durations":[4.2,3]}'{
"amount_usd": 1.076479,
"list_usd": 1.133136,
"list_price_source": "official",
"list_price_label": "Official",
"discount_pct": 5,
"available": true,
"currency": "usd",
"reference_video_seconds": 7.2
}Ricarica automatica#
La ricarica automatica evita che i lavori in produzione si interrompano per 402. In Dashboard → Fatturazione, salva una carta e scegli una soglia e un importo. Dopo ogni addebito, se il saldo scende sotto la soglia, addebitiamo sulla carta salvata l'importo scelto e lo aggiungiamo al saldo.
Se un pagamento di ricarica non va a buon fine
La ricarica automatica viene sospesa e il motivo è mostrato nella dashboard. Le generazioni continuano finché il saldo non si esaurisce; a quel punto le richieste restituiscono402 insufficient_balance. Aggiorna la carta per riattivarla.Piani mensili#
Il pagamento a consumo non richiede un piano. Se generi contenuti ogni mese, un piano aggiunge crediti automaticamente e può ridurre i prezzi:
- Starter — $99 al mese, accreditati interamente sul tuo saldo, ai prezzi standard.
- Pro — $499 al mese, accreditati interamente sul tuo saldo, oltre a prezzi Pro, più bassi per la maggior parte dei modelli.
- Max — $4999 al mese, accreditati interamente sul tuo saldo, oltre a prezzi Max, più bassi per la maggior parte dei modelli.
I crediti del piano si accumulano e non scadono mai, come tutti gli altri crediti. I piani si rinnovano ogni mese fino alla disdetta; la disdetta diventa effettiva alla fine del mese pagato. Passando a un piano superiore, il nuovo mese inizia subito e viene addebitato il prezzo del piano meno il credito residuo del mese in corso, che viene aggiunto al saldo. Il passaggio a un piano inferiore è immediato e il successivo addebito mensile corrisponde al nuovo prezzo. Con un piano Pro o Max attivo, la maggior parte dei modelli costa meno: lo sconto dipende dal modello e la relativa pagina mostra i prezzi del piano sotto ciascun prezzo. Il piano non riduce il prezzo specifico di un modello per le richieste con il controllo di sicurezza disattivato. Le richieste al prezzo del piano riportano custom_price: true e volume_level nel preventivo e nella generazione; GET /api/v1/account/pricing mostra il tuo piano. Gestiscilo in Dashboard → Fatturazione. Ti serve di più? Possiamo concordare prezzi personalizzati.
Un piano non fa mai costare una richiesta più di quanto costerebbe senza piano. Il prezzo del piano è quello indicato nella pagina di ciascun modello e resta valido anche se la capacità prevista non è disponibile, purché un'altra capacità possa soddisfare la richiesta a quel prezzo. In caso contrario, per una nuova richiesta viene indicato un prezzo compreso tra quello del piano e il prezzo standard (quello applicato agli account pay-as-you-go), mai il prezzo di emergenza se gli account pay-as-you-go pagano il prezzo standard. Se la capacità di un lavoro già accettato al prezzo del piano non è più disponibile, il lavoro può passare a un'altra capacità a un prezzo maggiore, fino al prezzo standard: questo vale per l'API REST e MCP, a meno che la richiesta non abbia inviato allow_fallback_price: false, e solo entro max_cost_usd (in quel momento viene trattenuto l'importo aggiuntivo e pricing della generazione non mostra più volume_level). I lavori avviati in Studio non superano mai il prezzo mostrato al momento del clic: in quel caso non riescono e vengono rimborsati per intero.
Controllare il saldo#
GET /api/v1/account restituisce il saldo, il credito per immagini e le impostazioni di ricarica automatica:
curl https://cheapergen.com/api/v1/account \
-H "Authorization: Bearer $CHEAPERGEN_API_KEY"{
"object": "account",
"email": "you@company.com",
"balance_usd": 42.5,
"image_credit_usd": 0,
"reserved_usd": 1.2,
"auto_topup": {
"enabled": true,
"threshold_usd": 10,
"amount_usd": 50
},
"limits": {
"unlimited": false,
"concurrent_generations": 20,
"in_flight": 3,
"requests_per_second": 10,
"burst": 20,
"tier": null
}
}balance_usd— importo subito disponibile per le spese. Gli importi riservati per le generazioni in corso sono già stati detratti.image_credit_usd: un credito riservato alle immagini, ad esempio un credito di benvenuto; viene usato prima per le generazioni di immagini, mai per i video.reserved_usd: il totale attualmente trattenuto dal saldo per le generazioni in coda o in corso. Al termine, l’importo viene addebitato oppure rimborsato.
Registro movimenti#
Ogni variazione del saldo viene registrata nel libro mastro in Dashboard → Fatturazione, insieme al saldo dopo ogni movimento:
| Operazione | Descrizione |
|---|---|
TOPUP | Crediti aggiunti con carta. |
AUTO_TOPUP | Crediti aggiunti automaticamente tramite ricarica automatica. |
CHARGE | Importo bloccato all'invio di una generazione (negativo). |
REFUND | Un importo bloccato restituito: per intero se la generazione è fallita o è stata annullata, oppure la differenza se il suo prezzo è sceso prima che partisse (una generazione bloccata al prezzo di emergenza che era in attesa). |
ADJUSTMENT | Credito aggiunto al saldo da CheaperGen (per esempio, per un gesto commerciale o una rettifica), oppure rettifica di un importo precedente. Può essere usato come una ricarica, ma non è un pagamento e quindi non ha una fattura. |
PROMO | Crediti promozionali o di cortesia concessi da noi. Un credito per immagini (ad esempio, un credito di benvenuto) vale solo per i modelli di immagini, mai per i video: resta separato dal saldo, viene usato prima per le generazioni di immagini e viene rimborsato sullo stesso credito. |
BANK_TRANSFER | Crediti derivanti da un bonifico bancario (wire / ACH) o da un altro pagamento effettuato fuori dal checkout con carta, come WeChat Pay o Alipay, aggiunti al saldo all'arrivo dei fondi. Sono indicati come “Pagamento bancario / offline” e accompagnati da una fattura. Se il pagamento viene stornato, una voce negativa lo detrae e una nota di credito annulla la relativa fattura. |
Qualcosa non è chiaro o manca? Scrivi a support@cheapergen.com: leggiamo ogni messaggio.