Erreurs et idempotence
Erreurs standard, retries, limites et prévention des doublons.
Les erreurs utilisent application/problem+json, le vrai statut HTTP et request_id.
Les créations exigent un Idempotency-Key de 8–128 caractères. Seuls le HMAC et l'empreinte de requête sont stockés. Même Key/corps renvoie la tâche initiale ; corps différent renvoie 409 idempotency_conflict ; requête active renvoie 409 request_in_progress. Ne générez pas de nouvelle Key lors d'un retry automatique.
Codes courants : invalid_api_key, invalid_api_key_rate_limited, api_key_expired, insufficient_scope, validation_error, unsupported_model, unsupported_parameter, input_url_not_allowed, insufficient_credits, payment_required, account_suspended, network_not_allowed, rate_limit_exceeded, concurrency_limit_exceeded, provider_unavailable, service_unavailable.
Les identifiants invalides répétés depuis la même IP sont aussi limités ; seule une empreinte IP protégée par Pepper HMAC est stockée.
Réessayez les erreurs réseau, 429, 503 avec backoff, même corps et même Key. Si le résultat Provider est incertain, l'API refuse un renvoi aveugle.
Respectez toujours le header Retry-After avant de réessayer.