Criar minha primeira campanha
Aprovar e entregar · API e webhooks

Crie banners pelo seu próprio sistema, com uma API.

Uma API é a forma de pedir banners pelo seu código. Teste sem gastar créditos e receba um webhook (um aviso automático assinado) quando o trabalho terminar.

Criar minha primeira campanhaVer o tutorial
See the developers page
POST /api/v1/bannersbm_test_…
Idempotency-Key: 7c1e9a52

{
  "prompt": "Sua manhã, bem torrada",
  "sizes": ["300x250", "728x90"],
  "locales": ["es-CR", "en-US"]
}

→ 202 { "id": "job_test_…", "status": "queued" }
As chaves de teste não gastam créditos.

Crie banners pelo seu código

Um pedido com o prompt, os tamanhos e os idiomas devolve um trabalho que gera um conceito em todos eles; você o consulta até terminar.

Avisos assinados

Registre um webhook e receba um evento (banner gerado, exportação pronta, revisão aprovada…) com uma assinatura que você pode verificar.

Seguro para testar

As chaves de teste devolvem um banner de amostra sem usar IA nem créditos. Se você repetir um pedido com a mesma chave de idempotência, não é cobrado duas vezes.

Como usar

Da chave ao banner, em três passos.

  1. Cria uma chave

    De teste (bm_test_…) para começar ou de produção (bm_live_…). É mostrada completa uma única vez.

  2. Faz o pedido

    Envia o prompt, os tamanhos e os idiomas, com um cabeçalho de idempotência.

  3. Espera o aviso

    Consulta o trabalho ou recebe o webhook quando o banner estiver pronto.

Dados principais

Custos, limites e requisitos.

Disponível em
Planos Equipe, Agência e Empresa.
Chaves
De produção e de teste; só uma impressão digital é guardada, não o valor.
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.

Recursos relacionados

ExportarPeça a exportação pelo seu código.Ver SegurançaChaves, permissões e registro de cada ação.Ver Equipe e funçõesQuem pode criar chaves e webhooks.Ver

Aprenda a usar passo a passo

Criar um banner com a APITutorialReceber avisos com webhooksTutorial

Exemplos de banners com este recurso

Nébula · finanças
Marejada · viagens
Pulso · esporte

Perguntas sobre api e webhooks

Em quais planos está a API?

Em Equipe ($99 por mês), Agência ($299 por mês) e Empresa (a partir de $1.500 por mês). O Starter não inclui API nem webhooks.

Gasto créditos ao testar?

Não com as chaves de teste: elas devolvem sempre um banner de amostra, sem IA nem créditos. As chaves de produção usam os mesmos créditos do app.

O que acontece se eu repetir um pedido?

Com o cabeçalho Idempotency-Key, repetir o mesmo pedido devolve o resultado anterior em vez de cobrar de novo.

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.

Conecte a BannerMotion à sua plataforma.

Teste com uma campanha real.

Criar minha primeira campanhaFalar com vendas