Salta ai contenuti

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.

CapacitàConsuma crediti?
Caricamenti e libreria dei fileIl caricamento e le query sono gratuiti
Traduzione dei file e downloadLa traduzione è a pagamento; i controlli dello stato e i download sono gratuiti.
PDF e strumenti per le immaginiGratuito
Operazioni sui documentiextract e pdf_to_html sono gratuiti; visual_extract viene addebitato per pagina effettivamente elaborata
Traduzione istantanea e batch dei segmentiFatturato in base all’utilizzo effettivo
Audio, video e vociFatturato in base all’utilizzo effettivo
Glossari, progetti, tag, ricerca e condivisioneGratuito
Registri di utilizzo, saldo e regolamentoGratuito
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.

  • 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.
GET /api/v1/jobs/{job_id}
GET /api/v1/artifacts?job_id={job_id}
GET /api/v1/billing/credits/balance
GET /api/v1/billing/credits/operations
GET /api/v1/usage/summary

Quando il budget di una chiave è esaurito, è comunque possibile consultare i job, i risultati e i registri dei crediti creati da quella chiave.