Aller au contenu

Services et autorisations

Une clé API est propre au compte qui l’a créée : elle ne peut appeler que les services accessibles à ce compte et n’a accès qu’aux ressources de ce même compte.

CapacitéCoûte des crédits ?
Téléchargements et bibliothèque de fichiersLe téléchargement et les requêtes sont gratuits.
Traduction de fichiers et téléchargementsLa traduction est payante ; les vérifications de statut et les téléchargements sont gratuits.
PDF et outils d’imageGratuit
Opérations sur les documentsextract et pdf_to_html sont gratuits ; visual_extract est facturé par page effectivement traitée
Traduction instantanée et par lots de segmentsFacturé en fonction de l’utilisation réelle
Audio, vidéo et voixFacturé en fonction de l’utilisation réelle
Glossaires, projets, balises, recherche et partageGratuit
Enregistrements d’utilisation, de solde et de règlementGratuit
SSE et webhooks (tâches de traduction de fichiers)Gratuit

L’état de service du compte, les formats de fichier, ainsi que les limites par requête et les limites de simultanéité s’appliquent également. Lorsqu’un service est indisponible, l’API renvoie une erreur explicite ; elle ne bascule jamais automatiquement vers un autre service.

Les clés API servent à appeler les points de terminaison décrits dans cette documentation. Une clé ne peut pas modifier l’adresse e-mail, le mot de passe, le numéro de téléphone ou le profil de connexion, ni créer, renouveler ou révoquer des clés API ; les actions nécessitant une confirmation dans un navigateur connecté ne peuvent pas non plus être effectuées à l’aide d’une clé. Protégez votre clé comme vous protégez le mot de passe de votre compte.

  • Les ressources créées avec une clé appartiennent au compte associé à cette clé.
  • Le solde appartient au compte ; chaque clé peut avoir son propre budget et ses propres paramètres de traduction autorisés.
  • Interrogées avec une clé, les opérations de crédit, les opérations documentaires et la liste des voix ne renvoient que les enregistrements dont la clé est le préfixe ; la liste des tâches et l’utilisation renvoient les totaux du compte.
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

Lorsque le budget d’une clé est épuisé, vous pouvez toutefois consulter les tâches, les résultats et les historiques de crédits créés par cette clé.