Adaptar variantes
El español que se habla en Madrid, el de Ciudad de México y un guion pensado para toda la región no son el mismo idioma en términos de marketing, aunque compartan la misma gramática. La API de Variantes Regionales toma un texto ya escrito en español y ajusta vocabulario, conjugaciones y registro para que coincida con la variante que realmente necesita, ya sea cambiar 'vosotros' por 'ustedes' o reemplazar 'coger el autobús' por algo que no suene extraño en Ciudad de México. Está pensada para equipos que escriben una sola vez y necesitan publicar correctamente en todos los países de habla hispana.
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.
Un idioma, públicos muy distintos
Un mensaje de soporte redactado en español peninsular con 'vosotros' y 'ordenador' suena extranjero en la mayor parte de América Latina, y lo contrario también es cierto: 'computadora' y 'ustedes' se leen claramente latinoamericanos para alguien en España. Las empresas que operan en ambos mercados o mantienen dos copias de todo o aceptan la fricción de usar la variante equivocada. Este endpoint elimina esa disyuntiva adaptando un mismo texto fuente a la variante de destino que pida.
Qué cambia y qué se mantiene igual
La adaptación toca vocabulario (coche/carro, móvil/celular), patrones de conjugación, marcadores de formalidad y modismos con carga regional, pero conserva el significado, el tono y el contenido exactamente como fueron escritos. Nada del mensaje en sí cambia; solo la forma en que una persona nativa de esa región lo diría naturalmente.
El español neutro como destino deliberado
El español neutro no es el dialecto de un cuarto país; es una convención de doblaje y locución construida durante décadas, pensada para contenido que debe viajar por todos los mercados hispanohablantes sin sonar extranjero en ninguno. Pedirlo como variante de destino es la decisión correcta para interfaces de producto, avisos legales o cualquier contenido dirigido a toda la región en lugar de a un país en particular.
Cómo funciona el flujo asíncrono
Envía el texto fuente y la variante de destino, recibe un task_id de inmediato y el texto adaptado llega por webhook firmado o mediante un enlace firmado válido por 24 horas. Como corre de forma asíncrona, puede encolar un catálogo entero de contenido para re-adaptarlo sin bloquear su aplicación en cada llamada individual.
Dónde encaja en su flujo de trabajo
Los equipos de localización suelen usarlo como una segunda pasada después de traducir del inglés, o como una conversión lateral entre dos variantes de español que ya están en producción: el tipo de tarea que es tediosa para una persona editora si tiene que mantenerla consistente en miles de textos, pero que un paso automatizado puede resolver sin esfuerzo.
Qué puede hacer con ella
Expansión de España a América Latina
Un producto SaaS con interfaz en es-ES necesita una versión es-MX para su lanzamiento en México sin retraducir todo desde cero ni contratar a una segunda persona redactora.
Unificar contenido de soporte
Un centro de ayuda escrito por distintos equipos regionales a lo largo de los años se normaliza en una sola versión de español neutro para que todos los mercados vean terminología consistente.
Guiones de doblaje y locución
Un guion adaptado para un lanzamiento en streaming en América Latina se convierte a español neutro para que suene natural tanto en Argentina como en Colombia y México.
Textos legales y de cumplimiento
Unos términos de servicio redactados en México necesitan una revisión a es-ES antes de publicarse en España para evitar expresiones regionales que puedan resultar confusas para el lector español.
Preguntas frecuentes
¿Qué cambia exactamente esta API en el texto?
Adapta vocabulario, formas verbales y modismos con carga regional para que coincidan con la variante de español de destino, manteniendo intactos el significado y el tono originales.
¿Qué variantes admite?
Las variantes principales son es-ES, es-MX y español neutro; se indica la variante de origen y de destino en la solicitud.
¿Hay alguna forma gratuita de probarla?
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.
¿Cuál es el precio?
$0.003 por solicitud más $0.0135 por cada 1.000 palabras, y solo se cobra por las tareas que terminan con éxito.
¿Puede adaptar otros dialectos además de España y México?
Los destinos publicados son es-ES, es-MX y español neutro; el español neutro suele ser la mejor opción para otros mercados latinoamericanos no cubiertos de forma individual.
¿También traduce desde el inglés?
Este endpoint adapta español a español; si su texto original está en otro idioma, combínelo primero con una tarea de traducción.
¿Cómo proceso un lote grande de textos?
Envíe cada texto como una solicitud asíncrona independiente y recoja los resultados por webhook, lo cual escala bien para catálogos de miles de cadenas.
¿Se guarda mi contenido a largo plazo?
No, los resultados se eliminan después del período de retención y nunca se usan para entrenar modelos.
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/regional \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"…"}'const res = await fetch("https://api.kit.forhosting.com/translate/regional", {
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/regional",
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/regional", 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/regional", 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.regional",
"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. |