Créer ma première campagne
Approuver et livrer · API et webhooks

Créez des bannières depuis votre propre système, avec une API.

Une API est la façon de demander des bannières depuis votre code. Essayez-la sans dépenser de crédits et recevez un webhook (un avis automatique signé) lorsque le travail est terminé.

Créer ma première campagneVoir le tutoriel
See the developers page
POST /api/v1/bannersbm_test_…
Idempotency-Key: 7c1e9a52

{
  "prompt": "Votre matin, bien torréfié",
  "sizes": ["300x250", "728x90"],
  "locales": ["es-CR", "en-US"]
}

→ 202 { "id": "job_test_…", "status": "queued" }
Les clés de test ne dépensent pas de crédits.

Créez des bannières depuis votre code

Une demande avec le prompt, les formats et les langues renvoie un travail qui génère un concept dans tous ces formats ; vous le consultez jusqu’à ce qu’il soit terminé.

Avis signés

Enregistrez un webhook et recevez un événement (bannière générée, export prêt, révision approuvée…) avec une signature que vous pouvez vérifier.

Sûr pour les tests

Les clés de test renvoient une bannière d’exemple sans utiliser l’IA ni de crédits. Si vous relancez une demande avec la même clé d’idempotence, elle n’est pas facturée deux fois.

Comment l’utiliser

De la clé à la bannière, en trois étapes.

  1. Vous créez une clé

    De test (bm_test_…) pour commencer, ou de production (bm_live_…). Elle n’est affichée en entier qu’une seule fois.

  2. Vous envoyez la demande

    Vous envoyez le prompt, les formats et les langues, avec un en-tête d’idempotence.

  3. Vous attendez l’avis

    Vous consultez le travail ou recevez le webhook lorsque la bannière est prête.

Données clés

Coûts, limites et exigences.

Disponible dans
Les forfaits Équipe, Agence et Entreprise.
Clés
De production et de test ; seule une empreinte est enregistrée, pas la valeur.
Webhook events
All 13 documented events are emitted today, including banner.generated, generation.failed, review.approved, and export.ready.
Signature
Standard Webhooks: webhook-id, webhook-timestamp, and webhook-signature headers (HMAC SHA-256, with a 5-minute tolerance) on every notice.

Fonctions associées

ExporterDemandez l’export depuis votre code.Voir SécuritéClés, permissions et journal de chaque action.Voir Équipe et rôlesQui peut créer des clés et des webhooks.Voir

Apprenez à l’utiliser pas à pas

Créer une bannière avec l’APITutorielRecevoir des avis avec les webhooksTutoriel

Exemples de bannières avec cette fonction

Nébula · finance
Marejada · voyages
Pulso · sport

Questions sur api et webhooks

Dans quels forfaits se trouve l’API ?

Dans Équipe (99 $ par mois), Agence (299 $ par mois) et Entreprise (à partir de 1 500 $ par mois). Starter n’inclut ni API ni webhooks.

Dois-je dépenser des crédits pour tester ?

Non avec les clés de test : elles renvoient toujours une bannière d’exemple, sans IA ni crédits. Les clés de production utilisent les mêmes crédits que l’application.

Que se passe-t-il si je relance une demande ?

Avec l’en-tête Idempotency-Key, répéter la même demande renvoie le résultat précédent au lieu de facturer à nouveau.

How do I know a webhook is from BannerMotion?

Each notice carries the webhook-id, webhook-timestamp, and webhook-signature headers of the Standard Webhooks standard: an HMAC SHA-256 signature you verify with your webhook secret. The SDKs ship the verification ready to use.

Are there SDKs?

There are TypeScript and Python clients, not published yet [date to be confirmed]; ask for them at soporte@bannermotion.com. For any other language, use a client generated from the OpenAPI 3.1 specification.

Connectez BannerMotion à votre plateforme.

Essayez-le avec une vraie campagne.

Créer ma première campagneContacter les ventes