API para lenguaje claro y lenguaje fácil.
Envíe su texto de origen, el idioma de destino deseado y uno de los dos modos de idioma. Simple8 detecta automáticamente el idioma de origen y devuelve el texto terminado en el idioma de destino.
{
"text": "Contenido fuente complejo en el idioma seleccionado.",
"locale": "es",
"mode": "simple-language"
}Ejemplos de SDK y cURL disponibles
Punto final
POST /api/v2/translate
Crea un texto en lenguaje sencillo o simple y lo devuelve directamente en la respuesta HTTP.
Las cabeceras requeridas
| Título | El valor | Propósito |
|---|---|---|
| Authorization | Bearer <API_KEY> | Autenticación del espacio de trabajo |
| Content-Type | solicitud/json | Indica que la solicitud contiene JSON |
| Accept | solicitud/json | Requiere una respuesta JSON |
| Idempotency-Key | Sólo se requiere para antecedentes y órdenes colectivas | Previene las operaciones de doble trayecto |
Organismo de solicitud
Ninguna otra configuración de contenido forma parte del esquema de solicitud pública.
| Campo de trabajo | Tipo de producto | Requerido | Valor permitido | Descripción |
|---|---|---|---|---|
| text | cuerdas | Sí , es cierto . | De 1 a 5.000 puntos de código Unicode normalizados con NFC | Texto de partida |
| locale | cuerdas | Sí , es cierto . | Uno de los 136 códigos admitidos de 2 o 3 letras | Idioma de salida. El idioma de origen se detecta automáticamente. |
| mode | cuerdas | Sí , es cierto . | simple-language, easy-language | Modo de simplificación |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Organismo de respuesta
La respuesta incluirá el texto final y los datos de uso documentados.
| Campo de trabajo | Tipo de producto | Descripción |
|---|---|---|
| requestId | cuerdas | Identificador único para soporte y registros |
| locale | cuerdas | Idioma de destino seleccionado |
| mode | cuerdas | Modo de simplificación seleccionado |
| output | cuerdas | Texto terminado en el idioma de destino seleccionado |
| usage.inputCharacters | número entero | Caracteres contados para esta solicitud o 0 para un acierto de caché |
| usage.cacheHit | booleano | Si el resultado provino del caché de 180 días |
{
"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
}
}El comportamiento de validación
- Los campos ausentes, vacíos, desconocidos o no válidos devuelven HTTP 400 con el código de error invalid_request y los detalles de validación.
- La longitud del texto se mide en puntos de código Unicode después de la normalización NFC.
- La configuración regional debe ser uno de los 136 códigos documentados de 2 o 3 letras.
- El modo debe ser exactamente simple-language o easy-language.
- El texto fuente podrá estar escrito en un idioma distinto al especificado. Simple8 detecta automáticamente el idioma y crea el resultado en el idioma de destino seleccionado.