Idempotencia

Manda un header Idempotency-Key con un valor único por operación en los POST que cobran o reservan créditos.

Un reintento de red con la misma key devuelve el resultado original en vez de volver a ejecutar (y volver a cobrar o reservar).

Reglas

• Obligatorio en POST /v1/batches (reserva créditos): 428 si falta.
• Recomendado en POST /v1/generations.
• Reusar una key con otro payload devuelve 422 (no se te entrega el resultado de otra operación); reusarla en otro endpoint también. Usa una key distinta por operación.
• POST /v1/products (upsert) acepta el header, pero el upsert ya es idempotente por SKU. No reuses la misma key con un lote distinto: devolvería el conteo cacheado del primero sin escribir el nuevo.
• Una operación aún en vuelo con esa key devuelve 409: reintenta en un momento.