Explicar jerga
La traducción literal se rompe en cuanto alguien escribe 'échale ganas' o 'it's raining cats and dogs'. La API de Explicar Jerga lee la frase en su contexto y devuelve lo que realmente significa, junto con un equivalente en lenguaje claro que sus usuarios van a reconocer. Está pensada para tickets de soporte, chats, reseñas y textos de redes sociales, donde los modismos aparecen todo el tiempo y la traducción automática los arruina sin que nadie se dé cuenta.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
Por qué la traducción palabra por palabra falla
Los motores de traducción convencionales están entrenados para conservar la estructura de la oración, así que los modismos salen como algo sin sentido: 'romperse una pierna' suena a advertencia de accidente cuando en realidad significa 'mucha suerte'. Cualquiera que procese contenido generado por usuarios a gran escala —colas de soporte, foros, reseñas de producto— tarde o temprano choca con frases que se traducen bien en el papel pero no significan nada en la práctica. Este endpoint existe justamente para ese choque.
Qué devuelve exactamente el endpoint
Envía un texto y detectamos las expresiones coloquiales que contiene; después devolvemos cada una con su significado real, una frase equivalente en el registro de destino y una nota breve sobre el tono (jugoso, grosero, regional, anticuado). Recibe la explicación, no solo un sinónimo insertado, para que una persona revisora o un modelo posterior decida cómo redactar el resultado final.
Cómo encaja en un flujo automatizado
Como la llamada es asíncrona, envía el texto, recibe un task_id de inmediato y sus procesos quedan libres mientras nosotros trabajamos. El resultado llega por webhook firmado —la vía recomendada para integraciones— o mediante un enlace firmado válido por 24 horas si prefiere consultarlo usted mismo. En ningún caso queda algo esperando un tiempo de espera síncrono.
Un poco de dónde viene la jerga
El lenguaje idiomático se acumula por oficios, deportes, migración y medios de una forma que la gramática formal nunca predice: 'tirar la toalla' viene del boxeo, 'ghostear' viene de la cultura de las citas. Esa historia viva y desordenada es exactamente la razón por la que los diccionarios estáticos fallan y por la que esta tarea se beneficia de un modelo que razona sobre el uso en vez de buscar traducciones fijas.
Dónde ahorra más tiempo
Equipos que localizan macros de soporte al cliente, textos de marketing con sabor regional o sistemas de moderación que necesitan entender la intención detrás de la jerga (incluyendo eufemismos) usan este endpoint en lugar de anotar a mano listas de frases que quedan obsoletas en menos de un año.
Qué puede hacer con ella
Priorización de tickets de soporte
Un cliente escribe 'esta app está pero re mal, un desastre total' —el endpoint detecta la jerga cargada de frustración y su lógica de enrutamiento la trata como una queja de alta severidad.
Revisión de marketing regional
Antes de publicar una campaña en cinco países hispanohablantes, pasa el texto por el endpoint para detectar frases como 'está chida' o 'qué bacán' que suenan a jerga en algunos países y neutras en otros.
Contexto para moderación de chats
Un modelo de moderación necesita saber que 'es una serpiente' es una acusación de traición y no una afirmación literal, antes de decidir si el mensaje viola las políticas.
Subtítulos y capciones
Los generadores de subtítulos pasan el diálogo primero para que los modismos se expliquen en vez de transcribirse literalmente, dándole a la persona editora un punto de partida en lugar de una hoja en blanco.
Preguntas frecuentes
¿Qué hace exactamente la API de traducir jerga?
Identifica expresiones idiomáticas o coloquiales en un texto y devuelve su significado real más un equivalente en lenguaje claro, en vez de traducir cada palabra de forma literal.
¿Existe un plan gratuito?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Cómo se cobra la solicitud?
$0.003 por solicitud más $0.0135 por cada 1.000 palabras procesadas, y solo se cobran las tareas que terminan con éxito.
¿Qué pasa si una tarea falla?
Reintentamos automáticamente hasta tres veces; si sigue fallando recibe un error claro y nunca se le cobra por eso.
¿Cómo recibo el resultado?
Por webhook firmado, que es lo recomendado para integraciones, o mediante un enlace firmado que permanece válido durante 24 horas si prefiere consultarlo manualmente.
¿Reconoce diferencias regionales de jerga?
Sí —la explicación incluye una nota de tono y registro, que es justamente donde aparece el sabor regional, ya sea mexicano, argentino, caribeño, etc.
¿Puedo enviar texto extenso con muchos modismos a la vez?
Sí, puede enviar textos largos en una sola llamada; el precio escala según el número de palabras, así que agrupar textos resulta eficiente en vez de penalizado.
¿Mis datos se usan para entrenar modelos?
No. Los resultados se eliminan después del período de retención y nunca se usan para entrenamiento.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/translate/slang \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"…"}'const res = await fetch("https://api.kit.forhosting.com/translate/slang", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/translate/slang",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/translate/slang", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/translate/slang", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"text": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "translate.slang",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_tokens | 20000 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |