Approva e consegna · API e webhook

Crea banner dal tuo sistema, con un’API.

Un’API è il modo di richiedere banner dal tuo codice. Provala senza spendere crediti e ricevi un webhook (un avviso automatico firmato) quando il lavoro termina.

Crea la mia prima campagna Vedi il 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" }

Le chiavi di prova non consumano crediti.

Crea banner dal tuo codice

Una richiesta con il prompt, i formati e le lingue restituisce un lavoro che genera un concept in tutti; lo interroghi finché non termina.

Avvisi firmati

Registri un webhook e ricevi un evento (banner generato, esportazione pronta, revisione approvata…) con una firma che puoi verificare.

Sicuro da provare

Le chiavi di prova restituiscono un banner di esempio senza usare IA né crediti. Se ripeti una richiesta con la stessa chiave di idempotenza, non viene addebitata due volte.

Come si usa

Dalla chiave al banner, in tre passaggi.

Crei una chiave
Di prova (bm_test_…) per iniziare o di produzione (bm_live_…). Si mostra per intero una sola volta.
Fai la richiesta
Invii il prompt, i formati e le lingue, con un’intestazione di idempotenza.
Aspetti l’avviso
Interroghi il lavoro o ricevi il webhook quando il banner è pronto.

Dati chiave

Costi, limiti e requisiti.

Disponibile in: Piani Team, Agenzia ed Enterprise.
Chiavi: Di produzione e di prova; si salva solo un’impronta, non il valore.
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.

Funzioni correlate

EsportaRichiedi l’export dal tuo codice.Vedi SicurezzaChiavi, permessi e registro di ogni azione.Vedi Team e ruoliChi può creare chiavi e webhook.Vedi

Impara a usarlo passo dopo passo

Creare un banner con l’APITutorial Ricevere avvisi con i webhookTutorial

Esempi di banner con questa funzione

Nébula · finanza

Marejada · viaggi

Pulso · sport

Domande su api e webhook

Quali piani includono l’API?

Team (99 $ al mese), Agenzia (299 $ al mese) ed Enterprise (da 1.500 $ al mese). Starter non include API né webhook.

Consumo crediti nei test?

No con le chiavi di prova: restituiscono sempre un banner di esempio, senza IA né crediti. Le chiavi di produzione usano gli stessi crediti dell’app.

Cosa succede se ripeto una richiesta?

Con l’intestazione Idempotency-Key, ripetere la stessa richiesta restituisce il risultato precedente invece di addebitare di nuovo.

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.

Collega BannerMotion alla tua piattaforma.

Provalo con una campagna reale.

Crea la mia prima campagna Parla con le vendite