Saltar a la documentación

Reintentos e idempotencia

Recupera una operación sin pagar por accidente dos veces por la misma generación.

Actualizado el 31 de octubre de 2026

Las solicitudes independientes generan costes independientes

Cada POST independiente sin Idempotency-Key crea una operación nueva potencialmente facturable. Los ejemplos de los SDK usan maxRetries:0. Los reintentos de transporte no tienen garantía de ser gratuitos.

Reutiliza solo para la misma operación

Usa una sola clave de idempotencia para la misma entrada normalizada del modelo, herramientas y límite de salida. Cambiar la entrada con la misma clave genera un conflicto. No crees una clave nueva solo porque la respuesta haya sido incierta.

Una salida parcial no da derecho a un reintento gratuito

El servicio no repite una generación incierta o salida parcial como si no tuviera coste. Los errores nativos incluyen x-should-retry:false para impedir la repetición por parte del SDK. Respeta Retry-After explícito cuando se proporcione e inspecciona primero el estado.