Stock

Plan a video's stock B-roll — estimate

Price the request without executing it. Same body as POST /v1/stock/broll-plan.

post/v1/stock/broll-plan/estimate

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/stock/broll-plan/estimate
  • Auth: HTTP bearer

Request body

editobject

A POST /v1/studio/edit body (e.g. output.edit of POST /v1/studio/kinetic): the shots are merged into it and it comes back ready

kind'any' | 'video' | 'image'

any = video first, a photo where no clip fits

mode'auto' | 'full' | 'split'

cutaways: auto = portrait shots full frame, landscape ones as a split screen

cacheboolean

Copy each chosen file to our storage (24 h) — a render never depends on another host, and Pixabay's terms require it

countinteger

cutaways: how many shots

scrimboolean

A light dark band behind the words over the footage (cutaways: the shot's half; faceless: the word band) so small words read on busy pictures

style'cutaways' | 'faceless'

cutaways = 2–4 stock shots over a talking head · faceless = stock footage and photos over the whole video (the voice goes on)

topicstring

One line on what the video is about

verifyboolean

Show the best candidates' thumbnails to Gemini Flash-Lite before choosing (≈ $0.001–0.005)

context'general' | 'ad'

ad = an advert or a sales video: no stock person (and no brand) is shown, so nobody in the footage seems to endorse the product — with verify, every chosen shot's thumbnail was checked for a face or a logo

excludestring[]

Stock ids not to use (e.g. from an earlier plan)

secondsnumber

cutaways: how long each shot stays

durationnumber

The output's length in seconds (the kinetic plan's summary.output_seconds); default: the last word + 1.5 s

resolution'720' | '1080'

Default: the edit's output, else 1080

split_side'top' | 'bottom'

split: where the stock shot goes (bottom keeps the face on top, the words over the shot)

attribution'not-required' | 'any'

Only where the server's licence rule allows more than CC0 (setting stock_auto_license = cc0-and-free): not-required = CC0 / public domain / Pexels / Pixabay; any = CC BY too, with its credit line on screen while it shows (ShareAlike never). Under the default rule every shot is CC0.

aspect_ratio'9:16' | '16:9' | '1:1' | '4:5'

Default: the edit's output, else 9:16

shot_secondsnumber

faceless: a new shot about this often

speaker_focusnumber

split: which band of the speaker stays (0 top … 1 bottom; a selfie face ≈ 0.35)

transcript_idstring

Or a transcript whose clock is the output's (e.g. of the cut audio) — read here, its words in ms

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.