RÉFÉRENCE API
Simplifiez et traduisez le contenu dans 24 langues de sortie.
Le point de terminaison synchrone accepte le texte source, les paramètres régionaux de sortie et l'un des deux modes. Il détecte automatiquement la langue source et renvoie un résultat prêt à l'emploi dans la langue de sortie sélectionnée.
{
"text": "Contenu source complexe dans la langue sélectionnée.",
"locale": "fr",
"mode": "simple-language"
}Exemples de SDK et cURL disponibles
Point de terminaison
POST /api/v2/translate
Créez un résultat en langage clair ou en langage simple et renvoyez-le dans la même réponse HTTP.
En-têtes obligatoires
| En-tête | Valeur | Objectif |
|---|---|---|
| Authorization | Bearer <API_KEY> | Authentifie le projet avec le schéma HTTP Bearer actuel |
| Content-Type | application/json | Déclare le format du corps de la requête |
| Accept | application/json | Demande une réponse JSON |
| Idempotency-Key | Obligatoire pour les tâches et les lots uniquement | Empêche les soumissions asynchrones répétées de créer un travail en double |
Corps de la demande
Aucun autre paramètre de contenu ne fait partie du schéma de demande publique.
| Champ | Tapez | Obligatoire | Valeur autorisée | Descriptif |
|---|---|---|---|---|
| text | chaîne | Oui | 1 à 10 000 caractères Unicode | Contenu source dans les paramètres régionaux sélectionnés |
| locale | chaîne | Oui | L'un des 24 codes à deux lettres pris en charge | Langue de sortie. La langue source est détectée automatiquement. |
| mode | chaîne | Oui | langage simple, langage facile | Mode simplifié |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Corps de réponse
La réponse ne doit pas contenir de paramètres de requête retirés ni de tableau d'informations sur la qualité distinct.
| Champ | Tapez | Descriptif |
|---|---|---|
| requestId | chaîne | Identifiant unique pour le support et les journaux |
| locale | chaîne | Paramètres régionaux de sortie sélectionnés |
| mode | chaîne | Mode de simplification sélectionné |
| output | chaîne | Résultat final dans les paramètres régionaux de sortie sélectionnés |
| usage.inputCharacters | entier | Caractères comptés pour cette requête, ou 0 pour un accès au cache |
| usage.cacheHit | booléen | Si le résultat provient du cache de 30 jours |
{
"requestId": "req_sync_002",
"locale": "en",
"mode": "easy-language",
"output": "You need to send documents.\nSend the documents before the deadline.",
"usage": {
"inputCharacters": 78,
"cacheHit": false
}
}Comportement de validation
- Texte manquant : rejet avec une erreur de champ documentée.
- Texte vide : rejet avec une erreur de champ documentée.
- Paramètres régionaux non pris en charge : rejet ; ne remplacez jamais silencieusement un autre paramètre régional.
- Mode non pris en charge : rejeter ; ne choisissez jamais un mode automatiquement.
- Champ retiré inconnu : rejet avec une erreur axée sur la migration ou gestion uniquement via une couche de compatibilité explicitement versionnée.
- Le texte source peut utiliser une langue différente des paramètres régionaux. Simple8 détecte automatiquement la langue source et écrit le résultat dans les paramètres régionaux de sortie sélectionnés.