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.
Services que vous pouvez appeler
Section intitulée « Services que vous pouvez appeler »| Capacité | Coûte des crédits ? |
|---|---|
| Téléchargements et bibliothèque de fichiers | Le téléchargement et les requêtes sont gratuits. |
| Traduction de fichiers et téléchargements | La traduction est payante ; les vérifications de statut et les téléchargements sont gratuits. |
| PDF et outils d’image | Gratuit |
| Opérations sur les documents | extract et pdf_to_html sont gratuits ; visual_extract est facturé par page effectivement traitée |
| Traduction instantanée et par lots de segments | Facturé en fonction de l’utilisation réelle |
| Audio, vidéo et voix | Facturé en fonction de l’utilisation réelle |
| Glossaires, projets, balises, recherche et partage | Gratuit |
| Enregistrements d’utilisation, de solde et de règlement | Gratuit |
| 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.
Ressources et audit
Section intitulée « Ressources et audit »- 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.
Les requêtes sont gratuites
Section intitulée « Les requêtes sont gratuites »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/summaryLorsque 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é.