Ampliar texto
Le da tres viñetas y le devuelve un párrafo que suena como si alguien lo hubiera redactado a mano. La api ampliar texto está pensada para ese momento en que tiene los datos pero no el tiempo de redactarlos, y añade las transiciones y el tono necesarios sin inventar nada que no le haya dado.
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.
Quién termina necesitando esto
Equipos de producto que escriben notas de versión a partir de un changelog, agentes de soporte que convierten anotaciones abreviadas en una respuesta, y flujos de contenido que generan resúmenes cortos arriba en la cadena pero necesitan una versión más extensa más abajo, todos chocan con el mismo problema: los datos en bruto no se leen como texto redactado. text.expand existe exactamente para ese vacío, toma entradas breves y produce oraciones completas que conservan el significado original.
Qué pasa realmente con su entrada
Envía sus viñetas, notas o un párrafo corto a POST /text/expand y la tarea se encola de inmediato, devolviendo un task_id para que su aplicación no se quede esperando. El motor lee lo que envió, identifica cada pieza de información y la redacta como prosa conectada, añadiendo el tipo de frases de enlace que agregaría un editor humano en lugar de simplemente pegar oraciones.
Un formato más viejo que la web
El esquema y su ampliación son un par retórico tan antiguo como la composición misma: quienes escriben han redactado notas esqueléticas primero y prosa después, ya sea en fichas o en un documento con viñetas. Esta api mecaniza la segunda mitad de ese hábito, así que el esqueleto que ya tiene se convierte en el borrador que realmente publica, sin que tenga que hilar oración por oración.
Qué recibe y cuándo
Los resultados llegan mediante un webhook firmado en el momento en que la tarea termina, o puede recogerlos desde un enlace firmado que permanece válido durante 24 horas si el sondeo se ajusta mejor a su flujo. En cualquier caso, el texto ampliado vuelve como texto plano, listo para pegar en un CMS, una plantilla de correo o un documento.
Dónde encaja dentro de un flujo mayor
Como cada llamada es asíncrona y se identifica con un task_id, text.expand encaja bien en trabajos por lotes: ampliar mil listas de viñetas de producto durante la noche, o disparar una sola ampliación en el instante en que un agente de soporte envía sus notas abreviadas. Combina bien con endpoints de resumen o reescritura antes o después, porque la salida es solo texto, sin ningún formato especial que interpretar.
Qué puede hacer con ella
Notas de versión desde un changelog
Convierta viñetas escuetas tipo commit en un párrafo que los clientes puedan leer en un correo de actualización del producto.
Macros de soporte a respuestas
Transforme las notas abreviadas de un agente ('reembolso emitido, disculpa dada, descuento ofrecido') en una respuesta al cliente correctamente redactada.
De esquema a borrador
Tome el esquema de viñetas de un redactor para una sección de blog y genere el primer borrador en prosa completa antes de la edición humana.
Minuta de reunión a resumen
Amplíe una minuta recortada en un recuento narrativo apto para interesados que no estuvieron en la sala.
Preguntas frecuentes
¿Cómo decide la api ampliar texto qué añadir?
Solo elabora sobre la información presente en su entrada, añadiendo redacción, transiciones y estructura, nunca datos o afirmaciones nuevas.
¿Hay 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.
¿Cuál es el precio?
$0.003 por solicitud más $0.0135 por cada 1,000 palabras procesadas, cobrado únicamente sobre tareas que se completan con éxito.
¿Se cobra si una tarea falla?
No. Las tareas fallidas se reintentan automáticamente hasta tres veces, y solo se cobra cuando la tarea finalmente tiene éxito; de lo contrario recibe un error claro.
¿Cómo obtengo el resultado?
Mediante una llamada a su webhook firmado cuando la tarea termina, o descargándolo desde un enlace firmado válido por 24 horas.
¿Puedo enviar solicitudes en volumen?
Sí, POST /text/expand es asíncrono y devuelve un task_id por cada llamada, así que puede disparar muchas solicitudes en paralelo y recoger los resultados conforme llega cada webhook.
¿Qué idiomas soporta?
Cualquier entrada que envíe se procesa tal cual; el motor amplía en el idioma del texto de origen.
¿Mi texto se guarda o se usa para entrenar modelos?
El texto se conserva solo durante la ventana de retención necesaria para entregar el resultado y luego se elimina; nunca se usa 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/text/expand \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"…"}'const res = await fetch("https://api.kit.forhosting.com/text/expand", {
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/text/expand",
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/text/expand", 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/text/expand", 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": "text.expand",
"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. |