Gerar descrições

A geração síncrona: uma chamada, uma descrição por idioma. Esta operação cobra créditos.

Geração síncrona

Com o scope generate, peça a descrição de um produto. A chamada espera o motor terminar e devolve o resultado completo:

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

languages é opcional: sem ele, usa-se o conjunto de idiomas configurado da sua organização. Cobra-se SÓ pelos idiomas que dão certo — um idioma que falha não cobra nem aborta os demais. A resposta inclui o cobrado e seu saldo:

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

Envie um Idempotency-Key único por operação (recomendado): se o request cair pela rede, a nova tentativa com a mesma chave devolve o resultado original em vez de gerar — e cobrar — de novo. Veja o guia de Idempotência.

O que pode responder

Código	Significado
`402`	Saldo insuficiente. Corta antes de gerar: sem cobrança parcial.
`404`	O produto não existe (ou é de outra organização — não se distingue).
`429`	Limite de taxa (tente após Retry-After) ou teto de gasto diário de IA (sem Retry-After).
`503`	Serviço em pausa (manutenção / IA desligada). Nada foi cobrado.

Muitos produtos?

Para volume use os lotes assíncronos: mais baratos por descrição e sem conexões abertas para manter. A geração síncrona brilha em fluxos um-a-um (por exemplo, gerar ao cadastrar um produto).