APIで、ご自身のシステムからバナーを作成。
APIは、コードからバナーを依頼する方法です。クレジットを使わずに試せ、作業が完了するとWebhook（署名付きの自動通知）を受け取れます。
See the developers pageコードからバナーを作成
プロンプト、サイズ、言語を含むリクエストで、すべてにコンセプトを生成するジョブが返されます。完了するまで問い合わせられます。
署名付きのお知らせ
Webhookを登録すると、イベント（バナーの生成、書き出し完了、承認完了など）を、検証できる署名付きで受け取れます。
テストは安全
テスト用キーは、AIもクレジットも使わずにサンプルバナーを返します。同じIdempotency-Keyで再送しても、二重に課金されません。
キーからバナーまで、3ステップで。
キーを作成する
テスト用（bm_test_…）で始めるか、本番用（bm_live_…）を使います。キーは全体が一度だけ表示されます。
リクエストを送る
プロンプト、サイズ、言語を、Idempotencyヘッダー付きで送ります。
通知を待つ
ジョブを問い合わせるか、バナーの準備ができたらWebhookを受け取ります。
費用、上限、要件。
- 利用できるプラン
- チーム、エージェンシー、エンタープライズ。
- キー
- 本番用とテスト用があります。保存されるのは指紋（フィンガープリント）だけで、値そのものは保存されません。
- 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.
関連する機能
この機能を使ったバナーの例
APIとWebhookについてのよくある質問
APIはどのプランで使えますか？
チーム（月額$99）、エージェンシー（月額$299）、エンタープライズ（月額$1,500から）。Starterには、APIとWebhookは含まれません。
テストするとクレジットを使いますか？
テスト用キーでは使いません。常にサンプルバナーを返し、AIもクレジットも使いません。本番用キーは、アプリと同じクレジットを使います。
リクエストを再送するとどうなりますか？
Idempotency-Keyヘッダーを付ければ、同じリクエストを再送しても、二重に課金されず、前の結果が返されます。
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.