Traducir formal o informal
La misma frase escrita para la app de un adolescente y para un aviso legal de un banco necesita dos registros completamente distintos, y solo pedir 'traduce esto' no le indica a un modelo cuál elegir. Este endpoint recibe una preferencia de formalidad explícita junto con el texto, para que el resultado caiga en el tono que usted realmente buscaba y no en el que una traducción genérica prefiera por defecto.
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é un mismo idioma puede decir lo mismo de dos formas
El español, como el francés, el alemán y muchos otros idiomas, conserva una distinción gramatical que el inglés perdió en gran parte: tú frente a usted, du frente a Sie, tu frente a vous. Dirigirse a un cliente de tú en un país donde se espera usted para correspondencia formal suena presuntuoso o descuidado; hacer lo contrario en una app pensada para jóvenes suena rígido y desconectado. El inglés tiene su propia versión del mismo problema aunque no cambie de pronombre: 'Hey, quick heads up' y 'We are writing to inform you' traducen el mismo hecho de fondo en registros completamente distintos, y una traducción que ignora esa diferencia acierta en las palabras pero falla en el tono.
Qué espera el endpoint y qué devuelve
Envíe POST a /translate/formality con el texto de origen, el idioma destino y una preferencia de formalidad -formal o informal- y recibirá un task_id de inmediato mientras la traducción corre en segundo plano, el mismo patrón asíncrono de cualquier otro endpoint de traducción. El resultado respeta el registro solicitado a lo largo de todo el texto, no solo en el saludo inicial, así que un documento largo no se desvía de usted en el primer párrafo a tú en el quinto.
Dónde se toman hoy estas decisiones de formalidad
Las guías de estilo de bancos, hospitales, agencias gubernamentales y proveedores de software B2B ya especifican un registro de formalidad como política, muchas veces después de quejas reales de clientes por un tono que no encajaba con la relación. Las apps de consumo dirigidas a públicos jóvenes van en la dirección contraria de forma deliberada, eligiendo tú o un inglés casual porque ahí la formalidad se lee como distancia. Ninguna de las dos opciones es correcta de forma universal, depende por completo de la audiencia, el país y la voz de marca, y por eso mismo la preferencia debe ser explícita en lugar de adivinada.
Usarlo como configuración repetible, no como decisión única
Como la bandera de formalidad forma parte de cada solicitud, una empresa puede fijarla una sola vez por audiencia -informal para notificaciones push de una app, formal para correspondencia legal- y aplicar esa decisión de forma consistente en miles de cadenas traducidas sin que un traductor tenga que recordar el estilo de la casa cada vez. A $0.003 por solicitud más $0.0135 por cada 1000 palabras, pasar el mismo contenido por ambos registros para probar cuál funciona mejor, o mantener versiones formal e informal por separado del mismo aviso para distintos mercados, sale lo bastante barato como para hacerlo de forma rutinaria y no solo una vez durante un gran proyecto de localización.
Qué puede hacer con ella
Correspondencia bancaria y legal
Un banco traduce avisos de cuenta usando de forma consistente el registro formal con usted, acorde con el tono que los clientes esperan de una comunicación financiera oficial.
Notificaciones de apps para público joven
Una app de consumo traduce sus notificaciones push con un registro informal de tú para coincidir con su voz de marca cercana y casual en mercados hispanohablantes.
Documentación de software B2B
Un proveedor de software traduce sus correos de incorporación de forma formal para clientes empresariales, mientras mantiene casuales y cercanas las respuestas de su foro comunitario.
Pruebas de tono por región
Un equipo de marketing traduce el mismo copy de campaña en registro formal e informal para probar cuál conecta mejor con un segmento de mercado específico.
Preguntas frecuentes
¿Cómo controlo la formalidad al traducir con la API?
Envíe su texto, el idioma destino y una preferencia de formalidad formal o informal por POST a /translate/formality, y luego reciba el resultado por webhook o mediante un enlace firmado válido por 24 horas.
¿Es gratis la API de traducción con formalidad?
No, no hay plan gratuito ni prueba; cuesta $0.003 por solicitud más $0.0135 por cada 1000 palabras, y un trabajo fallido nunca se cobra.
¿Qué idiomas admiten la distinción de formalidad tipo tú y usted?
Los idiomas con distinción gramatical de formalidad, como el español, el francés y el alemán, aplican la preferencia directamente sobre pronombres y conjugaciones; otros idiomas ajustan el registro mediante elección de palabras y redacción.
¿La formalidad se mantiene consistente en un documento largo?
Sí, el registro solicitado se conserva a lo largo de todo el texto traducido y no solo en las primeras líneas.
¿Puedo obtener una versión formal y otra informal del mismo texto?
Sí, envíe dos solicitudes con el mismo texto de origen y distinta preferencia de formalidad para obtener ambas versiones.
¿En qué se diferencia de la traducción que conserva el tono?
El control de formalidad fija un registro explícito que usted elige; la traducción que conserva el tono en cambio detecta y traslada el tono que ya trae su texto de origen.
¿Puedo ejecutar traducción con formalidad por lote?
Sí, envíe una tarea asíncrona por texto con la preferencia de formalidad indicada, y reciba cada resultado por webhook a medida que se completa.
¿Se guarda mi texto después de traducirlo?
No, el texto enviado se elimina después del período de retención y nunca se usa 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/formality \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"…"}'const res = await fetch("https://api.kit.forhosting.com/translate/formality", {
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/formality",
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/formality", 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/formality", 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.formality",
"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. |