ForHosting KIT · Texto e IA

Clasificar texto

Usted define las categorías que le importan a su negocio, y este endpoint ordena cada texto en la que —o las que— corresponda, sin importar el volumen que le envíe. Sin taxonomía fija que sortear, sin reentrenar ningún modelo cada vez que cambia su lista de categorías.

● EstablePor solicitud + por ítem$0.003

Ejecutar — $0.003 + $0.0135/ítem Cómo funciona y API

Úselo desde WebAPIEmailApp prontoTelegram pronto

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é una taxonomía fija casi nunca alcanza

Los clasificadores genéricos suelen asumir un conjunto estándar de categorías —temas de noticias, sectores industriales, ese tipo de cosas— que rara vez coincide con las etiquetas exactas que un negocio real necesita, como 'disputa de facturación' frente a 'retraso de envío' frente a 'defecto de producto'. text/topic-classify recibe su lista de categorías como parte de la propia solicitud, así que el resultado encaja directamente en las categorías que su equipo ya usa, no en las que un modelo genérico usó por casualidad para entrenarse.

La mecánica de una llamada

Envía sus textos por POST a /text/topic-classify junto con las categorías que quiere considerar, y recibe de inmediato un task_id mientras la tarea corre de forma asíncrona. Al terminar, los resultados llegan por webhook firmado o mediante un enlace firmado válido por 24 horas, con cada elemento etiquetado según la categoría o categorías con las que coincidió, más un puntaje de confianza que puede usar para decidir qué necesita revisión humana.

De dónde viene la clasificación automática de texto

Ordenar documentos por tema es anterior a las computadoras: los catálogos de fichas de las bibliotecas y el Sistema de Clasificación Decimal Dewey resolvían el mismo problema para libros físicos hace más de un siglo. Lo que cambió es la velocidad y el nivel de detalle: en vez de un bibliotecario asignando un número por libro, un clasificador ahora puede asignar categorías a miles de textos cortos por minuto, y sus categorías no tienen que encajar en un esquema bibliotecario universal, solo tienen que encajar en su flujo de trabajo.

Dónde se gana su lugar

Equipos editoriales que ordenan un backlog de artículos entrantes por sección antes de publicar. Marketplaces que etiquetan automáticamente las publicaciones de productos en la categoría correcta del catálogo al subirlas. Equipos legales y de cumplimiento que preordenan grandes lotes de documentos por tipo antes de una revisión humana. Equipos de base de conocimiento que enrutan preguntas entrantes hacia la categoría correcta de artículos de ayuda.

Cómo encaja la clasificación en la automatización

Como usted controla la lista de categorías en cada llamada, este endpoint se adapta a medida que su taxonomía evoluciona: una nueva línea de producto o una nueva categoría de soporte no requiere reentrenar nada, solo actualizar la lista en su próxima solicitud. Combinado con el modelo de entrega asíncrona, encaja limpiamente en procesos de ingesta: clasificar al llegar, dejar que el webhook escriba la categoría en el registro, y construir lógica adicional sobre etiquetas que ya coinciden con la forma en que su equipo piensa el contenido.

Qué puede hacer con ella

Orden de backlog editorial

Clasifica un backlog de miles de artículos redactados según su taxonomía de secciones existente antes de que un editor siquiera abra la cola.

Categorización de publicaciones en marketplace

Etiqueta automáticamente las publicaciones nuevas de producto según la estructura exacta de su catálogo al subirlas, en vez de depender de que cada vendedor elija bien la categoría.

Enrutamiento de contenido de soporte

Ordena las preguntas entrantes de la mesa de ayuda hacia las categorías específicas de su base de conocimiento, reduciendo el tiempo hasta la respuesta correcta.

Orden de documentos al ingresar

Preclasifica un lote grande de documentos escaneados o extraídos por tipo —contrato, factura, correspondencia— antes de que un equipo de cumplimiento los revise.

Preguntas frecuentes

¿Cómo funciona la api para clasificar texto?

Envía sus textos junto con la lista de categorías en las que quiere que se ordenen a POST /text/topic-classify, y recibe la categoría o categorías correspondientes a cada elemento, entregadas por webhook o mediante un enlace firmado válido por 24 horas cuando termina la tarea asíncrona.

¿Puedo usar mis propias categorías en vez de una lista fija?

Sí, ese es el diseño central: envía su propia lista de categorías en cada llamada, así que la clasificación siempre corresponde a la taxonomía que realmente usa su negocio.

¿Un texto puede clasificarse en más de una categoría?

Sí, el resultado puede incluir varias categorías coincidentes con puntajes de confianza individuales cuando un texto realmente abarca más de un tema.

¿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 ítem, así que clasificar 2,000 publicaciones cuesta la tarifa base más $26, cobrando solo por los ítems que se completan.

¿Cuántas categorías puedo definir por solicitud?

Puede definir el conjunto de categorías que necesite su flujo de trabajo en cada llamada; mantener la lista enfocada y mutuamente distinta suele dar resultados más limpios y con mayor confianza.

¿Puedo clasificar lotes grandes de una sola vez?

Sí, el endpoint está diseñado para procesamiento en lote y asíncrono, así que un lote de miles de elementos corre sin mantener abierto el hilo de su aplicación.

¿Qué pasa con el texto enviado después?

El texto se elimina al terminar la ventana de retención y nunca se usa para entrenar modelos; los ítems fallidos se reintentan automáticamente hasta tres veces, y una tarea que nunca se completa jamás se cobra.

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

POSThttps://api.kit.forhosting.com/text/topic-classify

¿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/topic-classify \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"items":["valor-1","valor-2"]}'

const res = await fetch("https://api.kit.forhosting.com/text/topic-classify", {
  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/topic-classify",
    headers={"Authorization": f"Bearer {os.environ[&#39;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/topic-classify", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"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/topic-classify", 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.topic_classify",
  "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

Por solicitud$0.003

Por ítem$0.0135

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.

Ver la documentación completa del KIT →