Freigeben und liefern · API und Webhooks

Erstelle Banner aus deinem eigenen System, mit einer API.

Eine API ist der Weg, Banner aus deinem Code anzufordern. Teste sie ohne Credits und erhalte einen Webhook (eine automatische, signierte Benachrichtigung), sobald die Arbeit fertig ist.

Meine erste Kampagne erstellen Zum Tutorial

See the developers page

POST /api/v1/bannersbm_test_…

Idempotency-Key: 7c1e9a52

{
  "prompt": "Tu mañana, bien tostada",
  "sizes": ["300x250", "728x90"],
  "locales": ["es-CR", "en-US"]
}

→ 202 { "id": "job_test_…", "status": "queued" }

Testschlüssel verbrauchen keine Credits.

Banner aus deinem Code erstellen

Eine Anfrage mit Prompt, Größen und Sprachen liefert einen Auftrag, der ein Konzept in all diesen erzeugt; du fragst ihn ab, bis er fertig ist.

Signierte Benachrichtigungen

Registriere einen Webhook und erhalte ein Ereignis (Banner erzeugt, Export bereit, Freigabe erteilt …) mit einer Signatur, die du prüfen kannst.

Sicher zum Testen

Testschlüssel liefern ein Muster-Banner ohne KI und ohne Credits. Wenn du eine Anfrage mit demselben Idempotenz-Schlüssel wiederholst, wird nicht doppelt berechnet.

So wird es verwendet

Vom Schlüssel zum Banner, in drei Schritten.

Du erstellst einen Schlüssel
Test (bm_test_…) zum Einstieg oder Produktion (bm_live_…). Er wird nur einmal vollständig angezeigt.
Du stellst die Anfrage
Du sendest Prompt, Größen und Sprachen, mit einem Idempotenz-Header.
Du wartest auf die Benachrichtigung
Du fragst den Auftrag ab oder erhältst den Webhook, sobald das Banner fertig ist.

Wichtige Daten

Kosten, Grenzen und Anforderungen.

Verfügbar in: Team-, Agentur- und Unternehmensplänen.
Schlüssel: Produktions- und Testschlüssel; gespeichert wird nur ein Fingerabdruck, nicht der Wert.
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.

Lerne es Schritt für Schritt

Ein Banner mit der API erstellenTutorial Benachrichtigungen mit Webhooks empfangenTutorial

Banner-Beispiele mit dieser Funktion

Nébula · Finanzen

Marejada · Reisen

Pulso · Sport

Fragen zu „API und Webhooks“

In welchen Tarifen gibt es die API?

Im Team-Tarif (99 $ pro Monat), Agentur (299 $ pro Monat) und Unternehmen (ab 1.500 $ pro Monat). Starter enthält weder API noch Webhooks.

Verbrauche ich Credits beim Testen?

Nicht mit den Testschlüsseln: Sie liefern immer ein Muster-Banner, ohne KI und ohne Credits. Die Produktionsschlüssel verbrauchen dieselben Credits wie die App.

Was passiert, wenn ich eine Anfrage wiederhole?

Mit dem Header Idempotency-Key liefert die Wiederholung derselben Anfrage das vorherige Ergebnis zurück, statt erneut zu berechnen.

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.

Verbinde BannerMotion mit deiner Plattform.

Probiere es mit einer echten Kampagne aus.

Meine erste Kampagne erstellen Vertrieb kontaktieren