bruxel.aiDevelopers

Ejemplos

El flujo de integración en curl, Python y JavaScript. Reemplaza bxk_tu_llave por la que creaste en la consola.

Autenticar y verificar

Toda llamada lleva tu API key como Bearer token. Empieza confirmando que funciona con GET /v1/me.

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

Empujar tu catálogo

Sube o actualiza productos por SKU (upsert masivo, hasta 500 por request).

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"}]}'

Generar una descripción

Generación síncrona: cobra al éxito. El Idempotency-Key es recomendado para reintentos seguros.

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"]}'

Generar en lote

Para volumen: reserva créditos con Idempotency-Key obligatorio y haz poll hasta que el lote termine — el poll cobra los éxitos y reembolsa el 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"

Leer y exportar

Lee la descripción actual de un producto o exporta todo el catálogo timbrado a 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
Ejemplos — Bruxel