Marketing banner (picture or 15-second video) from a brief
One call with a short brief returns a finished marketing banner for a business, square 1080×1080: a picture (JPEG) in one of four styles, or a 15-second video (MP4 with music, plus a poster) in one of four animated styles. Asynchronous: the call answers 202; poll GET /v1/executions/{id} for output.url. Styles — pictures: natural (a person beside a big curved white panel, a handwritten line, a huge price, a gift ribbon, three benefits on a brush stroke), premium (a tall photo beside a black-and-gold panel, a framed second photo, gold icons, the price), clean (a white arch with the headline over a bright photo, a blue price box with a gift, a round stamp, two benefit pills), sporty (a cut-out person over slanted yellow-and-white bars on navy, a huge 'free' or price, a button); videos: motion-red (graphite and red: a full-screen hook, a split screen with the work and a counting price, numbered steps, a call to action), motion-gold (black and gold, round badges — food, evening), motion-sea (turquoise and coral, slanted bars — sea, sport, kids), motion-cream (cream and bronze, slow — spa, beauty, gifts). How it works: the planner writes the style's own fields from your brief (a local hook, the headline, the price, the gift, three benefits with icons, the button…) — prices, discounts, gifts, numbers and places ONLY from your brief, never invented; your own copy fields are kept as you wrote them. Media: your photos (images) and clips (videos) first; without them a picture style gets a photo generated for it (Gemini 3 Pro Image, composed for the style: the person where the panel leaves room) and an animated style gets free stock clips picked and checked for the topic (no stock person, no brand). Your business.logo_url sits in a badge of its own background colour; without one the business's name is set in its place. The main photo's subject is found and, in natural and sporty, cut out and laid over the panel. Text is set by our render engine — real Hebrew right to left, real fonts, prices and numbers read correctly; long words shrink to fit, never overflow. The videos carry a music bed of the style's mood from our library (or music: "none", or your own link) and soft transition sounds. Every banner also comes as an editable file, editable_url (PPTX: the photo, the logo and the design as separate layers, every text a real text box in its font, size and colour) — the customer drags it into Canva (or opens it in PowerPoint, Google Slides, Keynote) and changes a word, the price, the photo or the logo themselves; an animated banner's file is the moment of its offer, the footage's frame as the photo. Every banner comes with a post caption and at most 5 hashtags, and its plan: change a word, the price, a picture or the colours and send it to POST /v1/banner/render — no model runs again, only the render is charged. The files are kept 24 hours. The price is the real cost of what ran (the planner, each generated picture, the stock check, the render) times the standard markup; the estimate is the worst case and is what is reserved.
Billing: Real cost of the run × the standard markup: the planner, each generated picture or the stock check, and the render (a picture, or a 15-second video) · Rate limit: 6/min · Asynchronous
Request
- Base URL: https://apihub.co.il
- URL: https://apihub.co.il/v1/banner
- Auth: HTTP bearer
Headers
Replay-safe: the same execution is returned instead of charging twice
Group calls into one job (e.g. one video) — see GET /v1/usage?tag=…
Wait for the job inside this call (ms)
Request body
Response
Completed (or 202 while processing)
Changes
No recorded changes to this operation across all 2 revisions of this API.