Banners

New banners in the design of a banner you already have — estimate

Price the request without executing it. Same body as POST /v1/banner/clone.

post/v1/banner/clone/estimate

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/banner/clone/estimate
  • Auth: HTTP bearer

Request body

briefstring

What the new banner is for, in your words: the business, the offer, the price, the place, the gift, who it is for. Prices, numbers and places come ONLY from here (and from variants) — nothing is invented

countinteger

Without variants: how many different banners to make from the one brief (each with its own headline angle and photo, the same facts)

colors'auto' | 'reference'

auto = the business's own colours where they differ from the reference (a brand's colours when there is one) · reference = keep the reference's colours exactly

imagesstring[]

Your own photos to put in (the product, the place, a person) — they stay recognisable

formatsstring[]

The sizes of every banner: 1:1 (feed), 4:5 (feed, taller), 9:16 (story / reels), 16:9 (web / YouTube). The first is drawn from the reference, the others from that finished first one

quality'best' | 'fast'

best = Nano Banana Pro (the sharpest words and photos) · fast = Nano Banana 2.1 (about a third of the price)

brand_idstring

A brand of yours (GET /v1/brands): its name, colours, tone and logo — default = your default brand

language'he' | 'en'
logo_urlstring uri

Your logo (PNG with transparency is best): the real file is laid on the corner the design leaves calm, on a small white badge — never drawn by the model

variantsstring[]

Several offers at once, each its own banner in the same design — e.g. three products or three sales. brief then holds what they share (the business, the place)

referencestring uri required

The banner whose design you want (JPEG / PNG / WebP): an ad you made or liked. Its layout, type, colours, decorations and photo style are copied — never its words

photo_directionstring

A line on what the photo should show (who, where, the mood)

Response

Estimate

operationstring
estimated_creditsnumber
credits_to_reservenumber
estimated_usageobject
notestring nullable
sufficientboolean

Changes

No recorded changes to this operation across all 2 revisions of this API.