ai classification api

Una API de clasificación que devuelve probabilidades

Envía un estado y las etiquetas que permites. Recibe una probabilidad para cada etiqueta, además de la ganadora. Sin ingeniería de prompts, sin análisis de la salida y sin reintentos por JSON mal formado.

Qué hace la API

El endpoint acepta un estado —texto libre, JSON o una URL de imagen— y una lista de preguntas tipadas, cada una con sus respuestas permitidas. Devuelve una distribución de probabilidad por pregunta y la opción ganadora.

Como el conjunto de respuestas es cerrado, puedes llevar la respuesta directamente a un umbral: enruta cuando la confianza supere 0,8, escala cuando no lo haga y registra la distribución completa para su revisión.

  • Una solicitud, una respuesta, sin un segundo paso de análisis.
  • Puntuaciones de confianza sobre las que aplicar umbrales.
  • La misma forma tanto si el estado es texto, JSON o una imagen.

La solicitud, al detalle

Envía por POST un cuerpo JSON con una cadena state y un array questions. Cada pregunta tiene un id, un prompt y las opciones que permites. La respuesta replica los ids y te da probabilidades indexadas por opción.

No se almacena nada a menos que lo pidas. Las llamadas gratuitas se cuentan por sesión de navegador y las de pago por clave de API.

Precios sin sorpresas

El plan gratuito cubre la evaluación y los proyectos pequeños. Los planes de pago elevan el límite diario de decisiones y añaden enrutamiento prioritario en el modelo en vivo. Cada decisión se cuenta una sola vez, sea cual sea el tamaño del estado, así que un ticket de soporte largo no cuesta en silencio más que una frase.

Obtén una respuesta en treinta segundos

El playground usa el mismo endpoint que expone la API. Si el playground produce la distribución que quieres, la integración consiste en copiar esa solicitud en tu propio código.

Preguntas frecuentes

¿La API devuelve una sola etiqueta o una distribución?

Ambas cosas. Recibes una probabilidad para cada opción permitida y además la respuesta con mayor probabilidad, así que puedes aplicar umbrales en lugar de confiar en una sola etiqueta.

¿Puedo clasificar imágenes?

Sí. Un estado puede ser una referencia a una imagen, y ambos modelos Clef incorporan un codificador de visión.

¿Hay un plan gratuito?

Sí. El playground del navegador y una asignación diaria de decisiones de API gratuitas no requieren cuenta.

Sigue leyendo

Notas del modelo

Un correo corto cuando salga un nuevo modelo de decisión o cambie un benchmark. Sin spam, baja en un clic.