La API compatible de 1min.AI no deduplica solicitudes: los reintentos automáticos tras un corte necesitan un diseño propio
La API Chat Completions compatible con OpenAI de 1min.AI no admite claves de idempotencia, y reenviar una solicitud POST puede generar otro cargo. En los resúmenes por lotes o las tareas automatizadas, hay que distinguir entre un resultado incompleto, un coste ya generado y un proceso de negocio aún sin terminar antes de decidir si se reintenta.
Al conectar un proceso de resúmenes por lotes a 1min. AI, poder enviar solicitudes con un SDK conocido solo resuelve una parte de la integración. Lo que realmente afecta al funcionamiento sin supervisión es cómo responde el sistema cuando se interrumpe la conexión. La documentación oficial de la API compatible lo indica expresamente: no hay deduplicación de solicitudes ni claves de idempotencia; reintentar una solicitud POST constituye una nueva generación y puede generar otro cargo. Por tanto, conviene revisar por separado, antes de la integración, los reintentos automáticos habituales de la aplicación existente.
Este artículo trata sobre la API Chat Completions compatible con OpenAI de 1min. AI y se basa en la documentación oficial. No extrapola estas limitaciones a todas las herramientas de la plataforma ni se han realizado pruebas reales de fallos.
No recibir una respuesta completa no significa que no se haya generado un coste
La documentación recomienda configurar maxRetries o max_retries en 0 en el cliente. Si falta [DONE] en una respuesta en streaming, debe considerarse incompleta; cancelar la solicitud tampoco garantiza que sea gratuita, ya que el uso que el proveedor ya haya comunicado se seguirá facturando. Estas reglas implican que la aplicación debe registrar por separado «si el resultado está completo» y «si es posible que ya se haya consumido crédito», en lugar de resumir ambas cosas con una única marca de error.
Por ejemplo, una tarea en segundo plano que resume documentos de clientes cada día pierde la conexión después de recibir parte del texto. Si la cola de trabajo reenvía la solicitud inmediatamente, el mismo documento puede dar lugar a otra generación. Entregar después a un compañero el segundo resultado completo no elimina el posible coste del primer intento. Este ejemplo ilustra el riesgo; no es el registro de un incidente ocurrido en la plataforma.
La deduplicación del proceso de negocio debe estar en la propia capa de tareas
Una forma más prudente de evaluar la integración es asignar un identificador interno de tarea a cada entrada, registrar el modelo, el número de intentos y el estado de finalización, y aislar los resultados incompletos. Antes de procesar de nuevo una tarea, se comprueba si ya tiene un resultado utilizable y se decide entonces si se inicia una nueva generación. Este registro interno puede reducir el procesamiento duplicado en el negocio, pero no dota a la API del proveedor de una idempotencia de facturación que no ofrece.
Si una tarea realmente necesita reintentarse, hay que definir expresamente el número de intentos permitido y el presupuesto, y conservar x-request-id para que el personal de soporte pueda investigar. Este identificador sirve para localizar una solicitud; no debe tratarse como una clave de deduplicación. En los procesos que no admiten un consumo duplicado o que deben garantizar un procesamiento exactamente una vez, este límite puede pesar más que la comodidad de un punto de acceso unificado a los modelos. Será necesario añadir controles en la aplicación o elegir un servicio que se ajuste mejor a los requisitos.
Aunque el flujo haya terminado, hay que comprobar el resultado del proceso
La documentación oficial también advierte de que las respuestas rechazadas o truncadas no garantizan la estructura esperada y de que se deben comprobar message.refusal y finish_reason antes de procesarlas. Por tanto, recibir una transmisión completa es solo un punto de control: al producir resúmenes estructurados, también se debe verificar que estén todos los campos; si se van a ejecutar acciones propuestas por el modelo, la aplicación debe validar los parámetros y los permisos. No se debe considerar automáticamente que un JSON que se puede analizar constituye una instrucción ejecutable.
Antes de pasar a producción, se pueden usar ejemplos no sensibles para ensayar una respuesta completa, un corte durante la transmisión, un rechazo y un truncamiento, y comprobar que cada estado de la tarea se gestione de forma definida y que el tratamiento de errores no active solicitudes adicionales inadvertidamente. Esta es una lista de comprobaciones recomendada para la aceptación, no una certificación de compatibilidad ya realizada. Si estos estados se pueden registrar y controlar con claridad, la API unificada será más adecuada para el procesamiento por lotes; si la única estrategia es «si falla, inténtalo otra vez», mantener primero una revisión humana resulta más prudente que ampliar directamente la automatización.
Nota sobre el contenido:Este artículo se basa en información pública y sirve como referencia para comparar y elegir herramientas. Las funciones, los precios y las políticas relacionadas pueden cambiar en cualquier momento; consulta la información oficial más reciente.
Fuente original:docs.1min.ai