API pour langage clair et langage facile.
Envoyez votre texte source, la langue cible souhaitée et l'un des deux modes de langue. Simple8 détecte automatiquement la langue source et renvoie le texte fini dans la langue cible.
{
"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ée un texte en langage clair ou clair et le renvoie directement dans la réponse HTTP.
En-têtes obligatoires
| En-tête | Valeur | Objectif |
|---|---|---|
| Authorization | Bearer <API_KEY> | Authentification de l’espace de travail |
| Content-Type | application/json | Indique que la requête contient JSON |
| Accept | application/json | Demande une réponse JSON |
| Idempotency-Key | Uniquement requis pour les commandes de fond et collectives | Éviter les commandes à double arrière-plan |
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 | De 1 à 5 000 points de code Unicode normalisés en NFC | Le texte de base |
| locale | chaîne | Oui | L’un des 136 codes à 2 ou 3 lettres pris en charge | Langue de sortie. La langue source est détectée automatiquement. |
| mode | chaîne | Oui | simple-language, easy-language | Mode simplifié |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Corps de réponse
La réponse contient le texte fini et les données d'utilisation documentées.
| Champ | Tapez | Descriptif |
|---|---|---|
| requestId | chaîne | Identifiant unique pour le support et les journaux |
| locale | chaîne | Langue cible sélectionnée |
| mode | chaîne | Mode de simplification sélectionné |
| output | chaîne | Texte terminé dans la langue cible sélectionnée |
| 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 180 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
- Les champs manquants, vides, inconnus ou non valides renvoient HTTP 400 avec le code d’erreur invalid_request et les détails de validation.
- La longueur du texte est mesurée en points de code Unicode après normalisation NFC.
- Le paramètre régional doit correspondre à l’un des 136 codes à 2 ou 3 lettres documentés.
- Le mode doit être exactement simple-language ou easy-language.
- Le texte source peut être rédigé dans une langue autre que celle spécifiée. Simple8 détecte automatiquement la langue et crée le résultat dans la langue cible sélectionnée.