Salta ai contenuti

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.

GET /api/v1/billing/credits/balance
Terminal window
curl https://omnidoc.top/api/v1/billing/credits/balance \
-H "X-API-Key: $OMNIDOC_API_KEY"

Campi chiave:

CampoSignificato
availableMillicrediti disponibili ora, dopo aver saldato i debiti; negativi in caso di debito
debtDebito 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.
spentTotale di millicrediti saldati
expiredMillicrediti scaduti o ritirati
today_chargedMillicrediti regolati oggi
lotsLotti di credito attualmente validi e loro scadenza
GET /api/v1/billing/credits/plans

Un endpoint pubblico che non richiede l’accesso e restituisce i pacchetti in vendita (purchase_plans, indicizzati per codice piano). In vendita ora:

Codice pianoCreditiPrezzoBonus
credits_3000_v43,000¥9.90—
credits_10000_v410,000¥29.90—
credits_25000_v425,000¥698%
credits_50000_v4 (consigliato)50,000¥12916%
credits_125000_v4125,000¥29925%
credits_450000_v4450,000¥99935%
  • Il “Bonus” viene calcolato sul prezzo di 10.000 crediti pari a ¥29,90 ed è il campo bonus_percent; il pacchetto consigliato ha recommended: 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, mentre total_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.
  1. 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 con quota_exceeded=true, un lavoro multimediale termina con error_code=insufficient_credits) e non viene addebitato alcun importo. L’avvio di un lavoro non modifica il saldo.
  2. 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.
  3. 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.

GET /api/v1/billing/credits/operations?limit=20
GET /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.

GET /api/v1/usage?limit=50
GET /api/v1/usage/summary

I punti di fine utilizzo restituiscono il numero di file, i caratteri, i token e il tempo di elaborazione dell’account.

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.