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
/examplesa la navegación principal, al pie de página, al sitemap y allms.txt. - Cada ejemplo indica qué endpoint usa:
POST /api/v1/decisionscon clave, oPOST /api/decidesin 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 }.codesolo 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ó) decredit_exhausted(el crédito con el que el plan financia el modelo se agotó). GET /api/v1/usageinforma 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 conconcurrency_exceededyretry-after: 1.
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(aliasclef-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-flashtruncó 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.
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(aliaskev-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,kevykev-latestsiguen siendo alias del modelo predeterminado de este despliegue, y ahora se documentan como alias en lugar de dejarse a la suposición.kevno esjaredpalmer/kev-4b; nombrarkev-4bsí 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-4bse 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.
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/decisionssirve el contrato systemone: un estado más preguntas tipadas, con respuestas indexadas por id de pregunta.questionsse acepta como array de{id, …}o como objeto indexado por id.- Se acepta el cuerpo de etiqueta única de jevapi:
instructionsconlabels, respondido bajo el idcategory. - Las respuestas
uolllevannoul; las descorellevan un flotante en[0, niveles-1]con probabilidades por nivel y una leyenda. - Un bloqueo de borde se informa con sus cabeceras
cf-rayycf-mitigateden 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.