Descripciones de producto
Entra una hoja de cálculo con SKU, especificaciones y atributos; sale un catálogo de descripciones de producto distintas y vendibles, una tarea por ítem, encolada y entregada por webhook, para que una importación de 10.000 filas no se convierta en 10.000 horas de redacción. Está pensada para el catálogo completo, no para la página estrella de un solo producto.
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.
El problema de catálogo que resuelve
Un producto insignia merece la atención completa de un redactor, pero un catálogo de 10.000 SKU de fundas de teléfono, tornillería o rollos de tela nunca recibe ese trato de nadie, porque la economía simplemente no cierra. Si no se atiende, esa brecha se convierte en una tienda llena de fichas vacías, duplicadas entre variantes, o copiadas tal cual del feed de un fabricante que también usan todos los competidores. Este endpoint apunta exactamente a ese nivel intermedio de inventario: demasiado grande para redacción manual, demasiado importante para dejarlo en blanco.
Cómo es una solicitud
Una llamada a POST /text/product-description toma los atributos de un ítem —nombre, categoría, especificaciones, cualquier dato estructurado que tenga— y encola una tarea, devolviendo un task_id de inmediato. La descripción terminada llega después mediante un webhook firmado, la opción natural para un sistema de gestión de catálogo que ya escucha eventos, o mediante un enlace firmado válido por 24 horas para un lote manual más pequeño.
Por qué el precio por ítem importa en un catálogo
El trabajo de catálogo vive o muere según la economía por unidad: un generador de descripciones cobrado como suscripción plana o le cobra de más a una tienda pequeña o le cobra de menos a una empresa que ingiere el feed de un almacén completo. Cobrar $0.0135 por ítem más $0.003 por solicitud hace que el costo de describir un catálogo escale exactamente con su tamaño, y que un lanzamiento de temporada de 200 SKU cueste una fracción predecible de una importación completa de 10.000 SKU.
Cómo encaja en un flujo de catálogo
Como cada ítem es su propia tarea con su propio task_id, esto se integra de forma natural después de una importación de feed de productos o una sincronización con un PIM: encola una tarea de descripción para cada SKU nuevo o actualizado, deja que los webhooks completados escriban directamente de vuelta en el registro del producto, y no toca los SKU que no cambiaron en vez de regenerar todo el catálogo en cada ejecución.
Qué esperar en variedad y límites
Mientras más atributos distintos tenga un ítem, más se diferenciará su descripción de la de sus vecinos en el estante; una ficha con solo nombre y categoría se leerá más genérica que una con material, dimensiones y uso incluidos, lo cual es simplemente un reflejo de la entrada y no una falla del endpoint. No hay plan gratuito; el acceso requiere saldo prepago, y cualquier tarea que falla tras tres reintentos nunca se cobra, así que una ejecución de catálogo grande nunca factura por SKU que en realidad no se llegaron a describir.
Qué puede hacer con ella
Incorporación de un nuevo feed de proveedor
Un marketplace ingiere el feed crudo de especificaciones de un fabricante para 8.000 SKU nuevos y encola una tarea de descripción para cada uno antes de publicar las fichas.
Copy para lanzamientos de temporada
Una tienda de moda genera descripciones distintas para una colección de temporada de 300 artículos la misma tarde en que el equipo de compras cierra la línea.
Diferenciación de variantes múltiples
Una ferretería corrige un catálogo donde cada variante de tamaño de tornillo compartía el mismo texto, dándole a cada descripción de SKU sus propias dimensiones y uso específicos.
Expansión a nuevos marketplaces
Una marca que entra a un nuevo canal de venta regenera las descripciones de todo su catálogo para ajustarse al tono y la extensión de ese canal, una tarea por SKU.
Preguntas frecuentes
¿Cómo funciona la API de descripciones de producto?
Envía los atributos de un ítem a POST /text/product-description; la tarea se encola y la descripción terminada llega por webhook firmado o por un enlace firmado válido por 24 horas.
¿De verdad puede procesar un catálogo de 10.000 SKU?
Sí: cada SKU es su propia tarea encolada, así que un catálogo de cualquier tamaño se procesa como un lote de solicitudes individuales con precio independiente.
¿Hay un plan gratuito para generar catálogos en volumen?
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ánto cuesta por producto?
$0.003 por solicitud más $0.0135 por ítem, de modo que el costo de una ejecución de catálogo escala directamente con la cantidad de SKU descritos.
¿Las descripciones se duplican entre productos parecidos?
Cada solicitud se genera a partir de los atributos propios de ese ítem, así que los productos con especificaciones, materiales o dimensiones distintas reciben descripciones distintas en vez de un texto genérico repetido.
¿Qué pasa si una tarea de descripción falla?
Se reintenta automáticamente hasta tres veces; una tarea que finalmente falla devuelve un error claro y nunca se cobra.
¿Puedo actualizar solo los SKU nuevos o modificados?
Sí: como cada ítem es una tarea independiente, puede encolar descripciones solo para productos nuevos o actualizados y dejar el resto del catálogo intacto.
¿Qué datos de entrada necesita por producto?
Los atributos estructurados que tenga disponibles —nombre, categoría, especificaciones, materiales, dimensiones—, y entre más ricos sean, más específico y diferenciado resulta el texto.
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/product-description \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"items":["valor-1","valor-2"]}'const res = await fetch("https://api.kit.forhosting.com/text/product-description", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"items": [
"valor-1",
"valor-2"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/text/product-description",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"items": [
"valor-1",
"valor-2"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/text/product-description", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"items":["valor-1","valor-2"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/text/product-description", 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
{
"items": [
"valor-1",
"valor-2"
]
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "text.product_description",
"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. |