Utilisation, fiabilité et traitement des données
Comprenez les unités, niveaux, erreurs, nouvelles tentatives, identifiants, durées de conservation et l’activation hors ligne.
Unités, niveaux et cycles de facturation
Une unité de base couvre jusqu’à 1.000 points de code Unicode par texte, arrondis séparément au supérieur, avec un minimum d’une unité. Le niveau API applique son coefficient. Les fractions sont conservées en dixièmes d’unité.
| Niveau | Coefficient d’unité | Limite des requêtes natives |
|---|---|---|
| Standard | 1,0 | 64 textes · 200.000 points de code par texte |
| Batch | 0,5 | 200 textes · 200.000 points de code par texte |
| Real-Time | 1,6 | 4 textes · 4.000 points de code par texte |
Par exemple, deux textes de 800 caractères consomment 2 unités Standard, 1 unité Batch ou 3,2 unités Real-Time. Batch natif est un niveau de traitement moins prioritaire ; les tâches Azure asynchrones ont un cycle distinct.
Le quota du forfait est utilisé avant les packs. Le quota mensuel est réinitialisé à chaque cycle, sans report. Les packs n’expirent pas. Une montée en gamme payée ouvre un nouveau cycle avec le quota complet ; baisse ou résiliation prennent effet en fin de période. Vérifiez le montant dans le tableau de bord avant confirmation.
Consultez votre consommation dans Tableau de bord ou GET /v2/usage. Le portail de facturation fournit les factures PDF, les coordonnées de l’entreprise et les moyens de paiement. Les taxes applicables sont calculées au paiement et les factures envoyées par e-mail après achat.
Erreurs et nouvelles tentatives
Les erreurs de l’API native utilisent {"error":{"code":"…","message":"…","request_id":"…","retryable":false}}. Les points de terminaison compatibles Azure utilisent leurs propres formats d’erreur. Conservez X-Request-Id pour le diagnostic.
| Statut | Action |
|---|---|
| 401 | Vérifiez la clé, son état de révocation et l’environnement. |
| 402 | Ajoutez des unités ; l’erreur indique les quantités nécessaires et disponibles. |
| 403 | Vérifiez que le forfait inclut le niveau demandé. |
| 413 / 422 | Corrigez l’entrée ou divisez la requête dans les limites documentées. |
| 429 | Respectez Retry-After, puis réessayez avec un délai croissant et aléatoire. |
| 503 | Défaillance temporaire du service. Respectez Retry-After si présent. |
Les erreurs de validation et les requêtes rejetées avant traitement ne consomment pas d’unités. Une coupure de connexion ne prouve pas l’échec : conservez la référence et vérifiez la consommation avant de relancer un gros traitement. Les résultats synchrones ne sont pas conservés pour relecture.
Réessayez uniquement lorsque retryable vaut true, et attendez le délai de Retry-After lorsque cet en-tête est présent.
Traitement des données et clés
Les requêtes directes sont traitées en mémoire et ne sont pas stockées. Une requête qui désigne une session API ajoute ses nouveaux remplacements à cette session. Les données des tâches et les sessions API sont conservées pour une durée limitée et chiffrées. Les enregistrements d’utilisation contiennent des identifiants, des quantités et des horaires, pas de contenu. Nous n’utilisons pas vos contenus pour entraîner des modèles.
Traitement et conservation des données
Créez et révoquez les clés API dans le tableau de bord. Starter autorise une clé ; les forfaits supérieurs jusqu’à cinq. Les clés de production commencent par shr_live_, celles du bac à sable par shr_test_. Elles appartiennent à des environnements distincts. Ne les intégrez pas dans des applications navigateur, URL ou messages d’assistance.
Activation hors ligne
