bruxel.ai

Exemplos

O fluxo de integração em curl, Python e JavaScript. Substitua bxk_sua_chave pela que você criou no console.

Autenticar e verificar

Cada chamada leva sua API key como token Bearer. Comece confirmando que funciona com GET /v1/me.

curl -s https://bruxel.ai/api/public/v1/me \
  -H "Authorization: Bearer bxk_tu_llave"

Enviar seu catálogo

Crie ou atualize produtos por SKU (upsert em massa, até 500 por requisição).

curl -s -X POST https://bruxel.ai/api/public/v1/products \
  -H "Authorization: Bearer bxk_tu_llave" \
  -H "Content-Type: application/json" \
  -d '{"products":[{"sku":"CAMISA-001","name":"Camisa de lino","brand":"Acme"}]}'

Gerar uma descrição

Geração síncrona: cobra no sucesso. O Idempotency-Key é recomendado para novas tentativas seguras.

curl -s -X POST https://bruxel.ai/api/public/v1/generations \
  -H "Authorization: Bearer bxk_tu_llave" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: gen-camisa-001-v1" \
  -d '{"product_id":"prod_8f2","languages":["es","en"]}'

Gerar em lote

Para volume: reserve créditos com Idempotency-Key obrigatório e faça poll até o lote terminar — o poll cobra os sucessos e reembolsa o resto.

# 1) Envía el lote (Idempotency-Key OBLIGATORIO)
curl -s -X POST https://bruxel.ai/api/public/v1/batches \
  -H "Authorization: Bearer bxk_tu_llave" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: batch-2026-07-23-a" \
  -d '{"product_ids":["prod_8f2","prod_9a1"]}'

# 2) Poll hasta status "ended" (el GET cobra los éxitos y reembolsa el resto)
curl -s https://bruxel.ai/api/public/v1/batches/BATCH_ID \
  -H "Authorization: Bearer bxk_tu_llave"

Ler e exportar

Leia a descrição atual de um produto ou exporte todo o catálogo gerado em CSV.

# Descripción actual de un producto (por idioma)
curl -s "https://bruxel.ai/api/public/v1/products/prod_8f2/descriptions" \
  -H "Authorization: Bearer bxk_tu_llave"

# Catálogo completo a CSV (compatible con Adobe Commerce)
curl -s "https://bruxel.ai/api/public/v1/export/catalog.csv?language=es" \
  -H "Authorization: Bearer bxk_tu_llave" -o catalogo.csv
Exemplos — Bruxel