승인과 전달 · API와 웹훅

API로 여러분의 시스템에서 배너를 만드세요.

API는 여러분의 코드에서 배너를 요청하는 방법이에요. 크레딧을 쓰지 않고 시험해 보고, 작업이 끝나면 웹훅(서명된 자동 알림)을 받아요.

POST /api/v1/bannersbm_test_…

Idempotency-Key: 7c1e9a52

{
  "prompt": "아침을 여는 진한 한 잔",
  "sizes": ["300x250", "728x90"],
  "locales": ["es-CR", "en-US"]
}

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

테스트 키는 크레딧을 쓰지 않아요.

코드에서 배너 만들기

프롬프트, 사이즈, 언어를 담은 요청이 모든 사이즈에 대한 컨셉을 만드는 작업을 돌려줘요. 끝날 때까지 조회하면 돼요.

서명된 알림

웹훅을 등록하면 이벤트(배너 생성, 내보내기 준비 완료, 검토 승인 등)를 검증할 수 있는 서명과 함께 받아요.

안심하고 시험

테스트 키는 AI나 크레딧을 쓰지 않고 샘플 배너를 돌려줘요. 같은 Idempotency-Key로 요청을 다시 보내도 두 번 청구되지 않아요.

사용 방법

키에서 배너까지, 세 단계로.

키를 만들어요
시작할 때는 테스트 키(bm_test_…), 실제 운영에는 운영 키(bm_live_…). 전체 값은 한 번만 보여 줘요.
요청을 보내요
프롬프트, 사이즈, 언어를 Idempotency-Key 헤더와 함께 보내요.
알림을 기다려요
작업을 조회하거나, 배너가 준비되면 웹훅을 받아요.

핵심 정보

비용, 한도, 요구사항.

제공 플랜: 팀, 에이전시, 엔터프라이즈.
키: 운영 키와 테스트 키; 식별용 지문만 저장하고 값 자체는 저장하지 않아요.
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로 배너 만들기튜토리얼 웹훅으로 알림 받기튜토리얼

이 기능으로 만든 배너 예시

Nébula · 금융

Marejada · 여행

Pulso · 스포츠

API와 웹훅 관련 질문

API는 어떤 플랜에 있나요?

팀($99/월), 에이전시($299/월), 엔터프라이즈(월 $1,500부터)에 있어요. Starter에는 API와 웹훅이 포함되지 않아요.

테스트할 때 크레딧이 드나요?

테스트 키로는 아니에요. 항상 샘플 배너를 돌려주고, 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.

BannerMotion을 여러분의 플랫폼에 연결하세요.

실제 캠페인으로 시험해 보세요.

첫 캠페인 만들기 영업팀과 상담하기