Générer des descriptions

La génération synchrone : un appel, une description par langue. Cette opération facture des crédits.

Génération synchrone

Avec le scope generate, demandez la description d'un produit. L'appel attend la fin du moteur et renvoie le résultat complet :

POST /v1/generations
Idempotency-Key: gen-camisa-001-v1
{ "product_id": "…", "languages": ["es", "en"] }

languages est optionnel : sans lui, le jeu de langues configuré de votre organisation est utilisé. Vous n'êtes facturé QUE pour les langues qui réussissent — une langue en échec ne facture pas et n'interrompt pas les autres. La réponse inclut le montant facturé et votre solde :

{
  "results": [ { "language": "es", "status": "succeeded", … } ],
  "total_credits_charged": 20,
  "balance": 1214
}

Envoyez un Idempotency-Key unique par opération (recommandé) : si la requête est coupée par le réseau, la relance avec la même clé renvoie le résultat original au lieu de générer — et facturer — à nouveau. Voir le guide Idempotence.

Réponses possibles

Code	Signification
`402`	Solde insuffisant. Coupé avant de générer : aucune facturation partielle.
`404`	Le produit n'existe pas (ou appartient à une autre organisation — indiscernable).
`429`	Limite de débit (réessayez après Retry-After) ou plafond quotidien d'IA (sans Retry-After).
`503`	Service en pause (maintenance / IA désactivée). Rien n'a été facturé.

Beaucoup de produits ?

Pour le volume, utilisez les lots asynchrones : moins chers par description et sans connexions ouvertes à maintenir. La génération synchrone excelle pour les flux au fil de l'eau (par exemple, générer à la création d'un produit).