Crediti e utilizzo
I servizi fatturabili vengono regolati tramite crediti di account. Gli importi sono espressi in millicrediti (millicredits); 1000 millicrediti equivalgono a 1 credito. Gli importi inviati nelle richieste devono essere numeri interi; gli importi nei saldi e nei registri possono avere una cifra decimale (0,1 millicredito). credit_precision nelle risposte corrisponde a 4, il che significa al massimo 4 cifre decimali una volta convertiti in crediti.
Verifica il saldo
Sezione intitolata “Verifica il saldo”GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"Campi chiave:
| Campo | Significato |
|---|---|
available | Millicrediti disponibili ora, dopo aver saldato i debiti; negativi in caso di debito |
debt | Debito in millicrediti: la parte del costo effettivo dei lavori completati che ha superato il saldo. I crediti ricevuti successivamente (ricariche, sovvenzioni giornaliere, codici di riscatto, rimborsi e così via) vengono utilizzati per estinguere prima il debito. |
spent | Totale di millicrediti saldati |
expired | Millicrediti scaduti o ritirati |
today_charged | Millicrediti regolati oggi |
lots | Lotti di credito attualmente validi e loro scadenza |
Pacchetti di crediti
Sezione intitolata “Pacchetti di crediti”GET /api/v1/billing/credits/plansUn endpoint pubblico che non richiede l’accesso e restituisce i pacchetti in vendita (purchase_plans, indicizzati per codice piano). In vendita ora:
| Codice piano | Crediti | Prezzo | Bonus |
|---|---|---|---|
credits_3000_v4 | 3,000 | ¥9.90 | — |
credits_10000_v4 | 10,000 | ¥29.90 | — |
credits_25000_v4 | 25,000 | ¥69 | 8% |
credits_50000_v4 (consigliato) | 50,000 | ¥129 | 16% |
credits_125000_v4 | 125,000 | ¥299 | 25% |
credits_450000_v4 | 450,000 | ¥999 | 35% |
- Il “Bonus” viene calcolato sul prezzo di 10.000 crediti pari a ¥29,90 ed è il campo
bonus_percent; il pacchetto consigliato harecommended: true. Nessuno dei due campi viene visualizzato quando non è impostato. price_fen(in fen, 1/100 di yuan) è il valore di riferimento per il prezzo, mentretotal_millicredits(millicrediti) lo è per i crediti. I crediti acquistati non hanno scadenza; i pacchetti possono essere riacquistati e vengono consegnati in un’unica soluzione ogni volta.
Ciclo di carica
Sezione intitolata “Ciclo di carica”- Il saldo viene verificato rispetto a una soglia prima dell’avvio di un lavoro : il saldo (al netto dei debiti) deve superare la soglia del lavoro; ad esempio, “pagine × 2 crediti” per la traduzione PDF, la lunghezza del testo sorgente per gli altri file (almeno 2 crediti), e per audio, video e speech il costo calcolato in base alla durata o ai caratteri misurati dal server (prezzi in audio, video e voci ). Con una chiave API dotata di budget, anche il budget residuo della chiave deve superare la soglia. In caso contrario, la risposta è
402(un lavoro di traduzione file termina con errore conquota_exceeded=true, un lavoro multimediale termina conerror_code=insufficient_credits) e non viene addebitato alcun importo. L’avvio di un lavoro non modifica il saldo. - L’utilizzo effettivo viene addebitato al termine : la traduzione dei file (incluse le immagini), il testo ricco in batch, le operazioni sui documenti, l’audio, il video e la voce vengono addebitati integralmente in base all’utilizzo effettivo al completamento. Il budget di una chiave API interviene solo nel controllo prima dell’avvio e non riduce mai l’addebito per un lavoro completato; se ciò porta il budget utilizzato della chiave oltre il limite, la chiave non può avviare nuovi lavori finché il limite non viene aumentato. I lavori falliti o annullati non vengono addebitati.
- Il saldo può diventare negativo : la parte del costo effettivo che supera il saldo viene registrata come debito e il saldo risulta negativo; i crediti che arrivano successivamente estinguono prima il debito. Non è possibile avviare nuovi lavori finché il saldo è negativo; ricaricare.
I client non specificano mai “quanto dovrebbe essere addebitato”; il server calcola l’importo definitivo in base a quanto è stato effettivamente fornito.
Operazioni e registri
Sezione intitolata “Operazioni e registri”GET /api/v1/billing/credits/operations?limit=20GET /api/v1/billing/credits/operations/{operation_id}GET /api/v1/billing/credits/jobs/{job_id}Un record contiene l’ID dell’operazione, lo stato, la base di fatturazione e gli importi addebitati e rimborsati. Con un key API specificato, le operazioni elencate includono solo quelle avviate da tale key.
Utilizzo
Sezione intitolata “Utilizzo”GET /api/v1/usage?limit=50GET /api/v1/usage/summaryI punti di fine utilizzo restituiscono il numero di file, i caratteri, i token e il tempo di elaborazione dell’account.
Le query sono gratuite
Sezione intitolata “Le query sono gratuite”Controllare il saldo, lo stato dei lavori, l’utilizzo, i registri di regolamento, gli elenchi dei risultati e gli indirizzi di download non comporta alcun costo in crediti.