Registro de cambios

Cambios en la API de decisión que puedes observar desde fuera. Límites, modelos, formas de petición y errores, los más recientes primero.

2026-11-09 — Cinco ejemplos, y la página que los ejecuta

/examples incluye ahora cinco peticiones completas —triaje de soporte, moderación de comentarios, cualificación de leads, categorías de gasto y gravedad de incidentes—, cada una con el comando para ejecutarla, la forma de respuesta que debe producir y la variante sin clave de /api/decide cuando las preguntas lo permiten.

Los cuerpos de esa página no se copiaron de una sesión de terminal: se generan a partir de las mismas definiciones que la suite de pruebas envía a los handlers reales, con solo el proveedor del modelo simulado; un cuerpo que deja de aceptarse rompe la prueba en lugar de publicarse. La página promete como reproducible la petición y los invariantes de la respuesta —cada etiqueta declarada presente, cada distribución sumando 1, el modelo y el id de petición devueltos—. Las probabilidades no lo son, y la página lo dice.

  • Añadida /examples a la navegación principal, al pie de página, al sitemap y a llms.txt.
  • Cada ejemplo indica qué endpoint usa: POST /api/v1/decisions con clave, o POST /api/decide sin ella.
  • Cuando un cuerpo sin clave no puede llevar la petición completa, las preguntas que omite se nombran en lugar de desaparecer en silencio.

2026-10-27 — Códigos de error, una escalera de concurrencia publicada y /api/v1/usage

Las negativas llevan ahora un code estable junto a la frase legible, para que un cliente decida por el motivo en lugar de comparar prosa. La lista de códigos y los límites por plan están en /docs, y GET /api/v1/usage responde con esas mismas cifras para la clave que pregunta.

La concurrencia se cuenta ahora por clave de API y se publica: 8 peticiones en vuelo en Pro, 32 en Scale, 64 en Studio y 128 en Agency. Se cuenta en un Durable Object, uno por clave, porque varios isolates responden a la misma clave a la vez y un recuento por isolate es incorrecto por construcción: medido el 2026-10-27, un cliente sostuvo 8,7 peticiones por segundo a través del antiguo limitador por dirección, 286 llamadas en 33 segundos.

  • Todo cuerpo de error es ahora { ok: false, code, error }. code solo se amplía: un código nunca se reutiliza con otro significado. La lista completa está en /docs.
  • Los tres 429 se distinguen ahora: quota_exceeded (las decisiones de hoy), rate_limited (una ráfaga), concurrency_exceeded (demasiadas en vuelo). Antes de esta versión los tres eran el mismo 429.
  • El 402 distingue ahora plan_ended (la vigencia terminó) de credit_exhausted (el crédito con el que el plan financia el modelo se agotó).
  • GET /api/v1/usage informa los límites del plan, las peticiones en vuelo en este momento y el máximo del día para esa clave.
  • La concurrencia se cuenta y se informa desde esta versión. No se rechaza hasta el 2026-11-10T00:00:00Z: hasta entonces una llamada que supera el límite se responde, se registra y aparece en concurrency.current. Desde ese instante se rechaza con concurrency_exceeded y retry-after: 1.
Un límite más estricto se anuncia con al menos una versión de antelación, y por eso el contador llega antes que el rechazo. Las cifras publicadas son las que la página de precios muestra ahora junto a cada plan.

2026-10-27 — Clef-Omni y un límite de estado que no puede truncar

Un estado demasiado largo para un modelo se rechaza ahora en esta API antes de la llamada, con la ventana del modelo y los tokens de este estado en el error. Un 200 de /api/v1/decisions significa ahora que el modelo leyó el estado completo, algo que antes no siempre era cierto.

  • Añadido cloudflare/clef-omni (alias clef-omni), Cloudflare, contexto de 65.529 tokens, texto e imágenes, 0,15 USD por millón de tokens de entrada. Lee el estado más grande que acepta esta API.
  • Corregida la ventana publicada de cloudflare/clef: lee 16.384 tokens, no 65.537. Medido el 2026-10-27: 90.011 caracteres facturaron 16.246 tokens; 100.011, 120.011 y 200.011 caracteres facturaron exactamente 16.384, y el resto se descartó en silencio.
  • Cada modelo tiene ahora un tope local en caracteres —Clef-Flash 120.000, Clef 80.000, Clef-Omni 200.000, Kev-4B 20.000— y un estado que lo supera recibe un 413 que nombra el límite. Medido el mismo día, cloudflare/clef-flash truncó un estado de 150.011 caracteres y rechazó uno de 170.011: la misma clase de petición, dos resultados distintos.
  • Un 413 lleva ahora el modelo, su ventana de tokens y los tokens de esta petición, en lugar del cuerpo 422 en bruto del proveedor.
Esta versión va de que la respuesta sea creíble, no de más capacidad. Si un estado se rechaza, es la API diciendo que la respuesta se habría calculado con una parte de él.

2026-10-27 — Kev-4B y un catálogo de modelos real

La lista de modelos se publica ahora en un solo lugar en vez de quedar implícita en el analizador de peticiones, y se aplica: un nombre que no está en ella se rechaza en lugar de sustituirse.

  • Añadido jaredpalmer/kev-4b (alias kev-4b), el Kev 4B de pesos abiertos de Jared Palmer. Contexto de 8.192 tokens, solo texto, entrada facturada a 0,042 USD por millón de tokens.
  • jev, jev-latest, kev y kev-latest siguen siendo alias del modelo predeterminado de este despliegue, y ahora se documentan como alias en lugar de dejarse a la suposición. kev no es jaredpalmer/kev-4b; nombrar kev-4b sí lo es.
  • Un estado con imagen enviado a un modelo de solo texto devuelve ahora un 400 que nombra el modelo y los modelos que sí leen imágenes, en lugar de informar de una cuota de imágenes de cero.
  • Un estado de más de 20.000 caracteres enviado a jaredpalmer/kev-4b se rechaza localmente antes de la llamada, porque el proveedor responde a una petición de Kev demasiado grande con un error y ningún resultado parcial.
Las ventanas de contexto quedan ahora registradas para cada modelo. Clef-Flash lee 24.576 tokens; un estado más largo lo trunca el proveedor y se factura la ventana completa. Esto ya era cierto antes de hoy: se documenta ahora porque un 200 que perdió el final en silencio es peor que un rechazo.

2026-10-26 — el cuerpo que ya envía un cliente jev

El endpoint systemone dejó de exigir una reescritura en el lado del cliente. Las peticiones con la forma que envían los clientes jev y kev se aceptan sin cambios.

  • POST /api/v1/decisions sirve el contrato systemone: un estado más preguntas tipadas, con respuestas indexadas por id de pregunta.
  • questions se acepta como array de {id, …} o como objeto indexado por id.
  • Se acepta el cuerpo de etiqueta única de jevapi: instructions con labels, respondido bajo el id category.
  • Las respuestas uol llevan noul; las de score llevan un flotante en [0, niveles-1] con probabilidades por nivel y una leyenda.
  • Un bloqueo de borde se informa con sus cabeceras cf-ray y cf-mitigated en lugar de pegar la página de desafío.

2026-10-25 — imágenes y tamaño de la petición

Se levantaron para las peticiones con clave dos límites que se aplicaban a todos los llamadores, incluidas las claves de pago.

  • Estados con imagen: se aceptan URL de datos base64 y se pasan al modelo. Las URL remotas https:// siguen rechazándose, porque el modelo no descarga URL.
  • Cuerpo de la petición: el valor por defecto de 8.192 bytes ya no se aplica a las peticiones con clave. Las claves de pago aceptan cuerpos de hasta 8 MB y las gratuitas de hasta 64 KB.
  • Un 413 informa ahora de ambos límites —lo enviado y lo permitido— en lugar de un error de tamaño sin más.

Preguntas frecuentes

¿Cómo sé que un cambio de modelo no romperá mi pipeline?

Nombra el modelo explícitamente. cloudflare/clef-flash, cloudflare/clef, cloudflare/clef-omni y jaredpalmer/kev-4b son ids fijados; los alias siguen al modelo predeterminado de este despliegue y pueden moverse. Cada respuesta informa del modelo que respondió realmente, así que comparar ese campo entre ejecuciones es la comprobación.

¿Cambian los límites sin avisar?

Un límite que se vuelve más permisivo se anuncia aquí el día que se publica. Un límite que se vuelve más estricto se anuncia al menos una versión antes, salvo cuando el límite anterior nunca fue real: en ese caso se documenta de inmediato y la entrada lo dice.

Enviar un mensaje