---
title: "Marketing banner (picture or 15-second video) from a brief — estimate"
method: POST
path: "/v1/banner/estimate"
tags: ["Banners"]
---

# Marketing banner (picture or 15-second video) from a brief — estimate

`POST /v1/banner/estimate`

## Request

- Base URL: `https://apihub.co.il`
- URL: `https://apihub.co.il/v1/banner/estimate`
- Auth: HTTP bearer

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

## Request body

- object
  - `copy` object: Your own words for some fields (the rest are written for you); with every required field of the style the planner is skipped
    - `cta` string
    - `tag` string
    - `fine` string
    - `gift` string
    - `hook` string
    - `list` string[]
    - `tag2` string
    - `badge` object
      - `big` string, required
      - `sub` string
      - `top` string
      - `bottom` string
    - `chips` string[]
    - `hook2` string
    - `price` object
      - `amount` string, required
      - `prefix` string
      - `suffix` string
      - `currency` string
    - `script` string
    - `details` string
    - `end_big` string
    - `end_sub` string
    - `big_word` string
    - `end_icon` 'users' | 'award' | 'circle-parking' | 'coffee' | 'flame' | 'clock' | 'leaf' | 'shield-check' | 'shield' | 'droplets' | 'sparkles' | 'truck' | 'fish' | 'salad' | 'soup' | 'life-buoy' | 'map-pin' | 'sun' | 'star' | 'heart' | 'house' | 'hand-heart' | 'gift' | 'phone' | 'calendar-check' | 'scissors' | 'car-front' | 'baby' | 'graduation-cap' | 'cpu' | 'rocket' | 'waves' | 'wind' | 'thermometer-snowflake' | 'badge-check' | 'timer' | 'smile' | 'flower-2' | 'wine' | 'bath' | 'check' | 'message-circle' | 'dumbbell' | 'utensils' | 'pizza' | 'shopping-bag' | 'stethoscope' | 'paw-print' | 'book-open' | 'music' | 'camera' | 'wrench' | 'zap' | 'wifi' | 'percent' | 'tag' | 'headphones' | 'shirt' | 'bike' | 'plane'
    - `end_lead` string
    - `features` object[]
      - `icon` 'users' | 'award' | 'circle-parking' | 'coffee' | 'flame' | 'clock' | 'leaf' | 'shield-check' | 'shield' | 'droplets' | 'sparkles' | 'truck' | 'fish' | 'salad' | 'soup' | 'life-buoy' | 'map-pin' | 'sun' | 'star' | 'heart' | 'house' | 'hand-heart' | 'gift' | 'phone' | 'calendar-check' | 'scissors' | 'car-front' | 'baby' | 'graduation-cap' | 'cpu' | 'rocket' | 'waves' | 'wind' | 'thermometer-snowflake' | 'badge-check' | 'timer' | 'smile' | 'flower-2' | 'wine' | 'bath' | 'check' | 'message-circle' | 'dumbbell' | 'utensils' | 'pizza' | 'shopping-bag' | 'stethoscope' | 'paw-print' | 'book-open' | 'music' | 'camera' | 'wrench' | 'zap' | 'wifi' | 'percent' | 'tag' | 'headphones' | 'shirt' | 'bike' | 'plane', required
      - `label` string, required
    - `headline` string
    - `includes` string
    - `location` string
    - `headline2` string
    - `script_latin` string
  - `plan` object: A plan returned by an earlier call (possibly edited): nothing is planned or generated, only rendered
    - `copy` object, required
      - `cta` string
      - `tag` string
      - `fine` string
      - `gift` string
      - `hook` string
      - `list` string[]
      - `tag2` string
      - `badge` object
        - `big` string, required
        - `sub` string
        - `top` string
        - `bottom` string
      - `chips` string[]
      - `hook2` string
      - `price` object
        - `amount` string, required
        - `prefix` string
        - `suffix` string
        - `currency` string
      - `script` string
      - `details` string
      - `end_big` string
      - `end_sub` string
      - `big_word` string
      - `end_icon` 'users' | 'award' | 'circle-parking' | 'coffee' | 'flame' | 'clock' | 'leaf' | 'shield-check' | 'shield' | 'droplets' | 'sparkles' | 'truck' | 'fish' | 'salad' | 'soup' | 'life-buoy' | 'map-pin' | 'sun' | 'star' | 'heart' | 'house' | 'hand-heart' | 'gift' | 'phone' | 'calendar-check' | 'scissors' | 'car-front' | 'baby' | 'graduation-cap' | 'cpu' | 'rocket' | 'waves' | 'wind' | 'thermometer-snowflake' | 'badge-check' | 'timer' | 'smile' | 'flower-2' | 'wine' | 'bath' | 'check' | 'message-circle' | 'dumbbell' | 'utensils' | 'pizza' | 'shopping-bag' | 'stethoscope' | 'paw-print' | 'book-open' | 'music' | 'camera' | 'wrench' | 'zap' | 'wifi' | 'percent' | 'tag' | 'headphones' | 'shirt' | 'bike' | 'plane'
      - `end_lead` string
      - `features` object[]
        - `icon` 'users' | 'award' | 'circle-parking' | 'coffee' | 'flame' | 'clock' | 'leaf' | 'shield-check' | 'shield' | 'droplets' | 'sparkles' | 'truck' | 'fish' | 'salad' | 'soup' | 'life-buoy' | 'map-pin' | 'sun' | 'star' | 'heart' | 'house' | 'hand-heart' | 'gift' | 'phone' | 'calendar-check' | 'scissors' | 'car-front' | 'baby' | 'graduation-cap' | 'cpu' | 'rocket' | 'waves' | 'wind' | 'thermometer-snowflake' | 'badge-check' | 'timer' | 'smile' | 'flower-2' | 'wine' | 'bath' | 'check' | 'message-circle' | 'dumbbell' | 'utensils' | 'pizza' | 'shopping-bag' | 'stethoscope' | 'paw-print' | 'book-open' | 'music' | 'camera' | 'wrench' | 'zap' | 'wifi' | 'percent' | 'tag' | 'headphones' | 'shirt' | 'bike' | 'plane', required
        - `label` string, required
      - `headline` string
      - `includes` string
      - `location` string
      - `headline2` string
      - `script_latin` string
    - `brand` object
      - `name` string
      - `accent` string
      - `primary` string
      - `logo_url` string, uri
    - `clips` object[]
      - `url` string, uri, required
      - `start` number
      - `focus_x` number
      - `focus_y` number
    - `style` 'natural' | 'premium' | 'clean' | 'sporty' | 'motion-red' | 'motion-gold' | 'motion-sea' | 'motion-cream', required
    - `cutout` boolean
    - `caption` string
    - `version` 1
    - `hashtags` string[]
    - `language` 'he' | 'en'
    - `decor_url` string, uri
    - `music_url` string, uri
    - `photo_url` string, uri
    - `photo2_url` string, uri
    - `sticker_cut` boolean
    - `sticker_url` string, uri
  - `brief` string: The business and the offer in your words: what you sell, the price, the gift, the place, who it is for. Prices, discounts, gifts and places are taken ONLY from here — nothing is invented
  - `media` 'auto' | 'own' | 'ai' | 'stock': auto = your files when you send them, else: a generated photo (pictures) or free stock clips checked for the topic (videos) · ai = generate the photos (Gemini 3 Pro Image) · stock = free stock clips (videos only) · own = only your files
  - `music` union: Videos: auto = a track of the style's mood from our library · none = silence · or a link to your own music
    - 'auto' | 'none'
    - string, uri
  - `style` 'natural' | 'premium' | 'clean' | 'sporty' | 'motion-red' | 'motion-gold' | 'motion-sea' | 'motion-cream', required: natural · premium · clean · sporty (pictures, 1080×1080 JPEG) — motion-red · motion-gold · motion-sea · motion-cream (15-second videos, 1080×1080 MP4)
  - `images` string[]: Your own photos (JPEG / PNG / WebP): the first is the main picture, the second the framed one (premium). Without them: `media`
  - `videos` union[]: Animated styles: your own clips (MP4 / MOV), in order — each fills one window of the style (fewer clips are reused further in). A link, or { url, start, focus_x, focus_y }
    - union
      - string, uri
      - object
        - `url` string, uri, required
        - `start` number: where to start reading the clip, seconds
        - `focus_x` number: which part stays when the clip is cropped into its window: 0 left … 1 right
        - `focus_y` number
  - `brand_id` string: A brand of yours (GET /v1/brands): its name, logo and colours fill what `business` leaves out — `default` = your default brand
  - `business` object
    - `name` string: The business's name — printed in the logo's place when there is no logo
    - `accent` string: Your accent colour, #RRGGBB
    - `primary` string: Your main colour, #RRGGBB — replaces the style's
    - `logo_url` string, uri: Your logo (PNG with transparency is best; JPEG works — it sits in a round badge of its own background colour)
  - `language` 'he' | 'en'
  - `photo_direction` string: A line on what the generated photo should show (who, where, the mood)

## Response `200`

Estimate

- Estimate
  - `operation` string
  - `estimated_credits` number
  - `credits_to_reserve` number
  - `estimated_usage` object
  - `note` string, nullable
  - `balance` object
    - `available` number
  - `sufficient` boolean

---

[API](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai.md) · [All operations](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/revisions/a8caa42835ce?raw)