bruxel.ai

Exemples

Le flux d'intégration en curl, Python et JavaScript. Remplacez bxk_votre_cle par celle créée dans la console.

S'authentifier et vérifier

Chaque appel porte votre clé API comme jeton Bearer. Commencez par confirmer que ça marche avec GET /v1/me.

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

Importer votre catalogue

Créez ou mettez à jour des produits par SKU (upsert en masse, jusqu'à 500 par requête).

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

Générer une description

Génération synchrone : facture au succès. L'Idempotency-Key est recommandé pour des nouvelles tentatives sûres.

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

Générer par lot

Pour le volume : réservez des crédits avec un Idempotency-Key obligatoire et faites du poll jusqu'à la fin du lot — le poll facture les succès et rembourse le reste.

# 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"

Lire et exporter

Lisez la description actuelle d'un produit ou exportez tout le catalogue généré en 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
Exemples — Bruxel