Servizi e autorizzazioni
Una chiave API opera per l’account che l’ha creata: può chiamare i servizi utilizzabili da tale account e accedere esclusivamente alle risorse di quell’account.
Servizi che è possibile chiamare
Sezione intitolata “Servizi che è possibile chiamare”| Capacità | Consuma crediti? |
|---|---|
| Caricamenti e libreria dei file | Il caricamento e le query sono gratuiti |
| Traduzione dei file e download | La traduzione è a pagamento; i controlli dello stato e i download sono gratuiti. |
| PDF e strumenti per le immagini | Gratuito |
| Operazioni sui documenti | extract e pdf_to_html sono gratuiti; visual_extract viene addebitato per pagina effettivamente elaborata |
| Traduzione istantanea e batch dei segmenti | Fatturato in base all’utilizzo effettivo |
| Audio, video e voci | Fatturato in base all’utilizzo effettivo |
| Glossari, progetti, tag, ricerca e condivisione | Gratuito |
| Registri di utilizzo, saldo e regolamento | Gratuito |
| SSE e webhook (processi di traduzione dei file) | Gratuito |
Si applicano inoltre lo stato di servizio dell’account, i formati dei file, i limiti per richiesta e i limiti di concorrenza. Quando un servizio non è disponibile, l’API restituisce un errore chiaro; non passa mai a un altro servizio autonomamente.
Le chiavi API servono per chiamare gli endpoint descritti in questa documentazione. Una chiave non può modificare l’indirizzo email, la password, il numero di telefono o il profilo dell’utente connesso, né può creare, ruotare o revocare altre chiavi API; inoltre, le azioni che richiedono la conferma tramite un browser con sessione attiva non possono essere eseguite utilizzando una chiave. Proteggi la tua chiave come faresti con la password del tuo account.
Risorse e audit
Sezione intitolata “Risorse e audit”- Le risorse create con una chiave appartengono all’account della chiave.
- Il saldo appartiene al conto; ogni chiave può avere il proprio budget e le proprie impostazioni di traduzione consentite.
- Interrogando con una chiave, le operazioni di credito, le operazioni sui documenti e l’elenco delle voci restituiscono solo i record che iniziano con tale chiave; l’elenco dei lavori e l’utilizzo restituiscono i totali del conto.
Le query sono gratuite
Sezione intitolata “Le query sono gratuite”GET /api/v1/jobs/{job_id}GET /api/v1/artifacts?job_id={job_id}GET /api/v1/billing/credits/balanceGET /api/v1/billing/credits/operationsGET /api/v1/usage/summaryQuando il budget di una chiave è esaurito, è comunque possibile consultare i job, i risultati e i registri dei crediti creati da quella chiave.