Edit

Plan a documentary-style story with data graphics

Turns a talking-head video that tells a story into ONE ready body for POST /v1/studio/edit in the documentary look: the speaker in a vivid grade with dark corners and a jump-cut punch-zoom rhythm, captions of 2–3 heavy words with the spoken word in yellow (green for numbers and key words), and data cards on the story's facts — a year counting up, view counts that stay tiny, a wall of videos filling, a count against the clock with a progress bar, money raining, a line chart shooting up, a fortune counting to billions, a black title card — each on a white flash; a black-and-white chapter for the hard years; the ending held on a blurred frame with the questions that turn the story on the viewer; a driving music bed and a sound kit (CC0 by default). Every element is anchored to the words of the video's transcript. You send the picks (which card on which words); the answer carries the picker call — POST /v1/ai/text with the video as media returns them. Nothing is rendered here. Recipe: /skills/full-docu.md

Billing: Read request — the plan is free; the render is POST /v1/studio/edit · Rate limit: 60/min

post/v1/studio/story

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/studio/story
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Replay-safe: the same execution is returned instead of charging twice

X-Tagstring

Group calls into one job (e.g. one video) — see GET /v1/usage?tag=…

Request body

flashesinteger[]

Extra white flashes with a punch zoom, at these words

captionsboolean
keywordsinteger[]

Words that turn green when spoken (numbers do it on their own)

video_urlstring uri required

The source video (a public link or an upload's url)

resolution'720' | '1080' | 'auto'

auto: 1080 up to 100 s of video, 720 above (a long story at 1080 would outlast the render's time limit)

transcript_idstring

The transcript of the video itself (POST /v1/speech/transcripts on its url)

Response

Completed

idstring

Execution id — stable across internal retries; use it with GET /v1/executions/{id}

status'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
operationstring
tagstring nullable

Your X-Tag, if sent

created_atstring date-time
completed_atstring date-time nullable
outputobject

Operation result (see each operation). While a Studio render is processing: stage (queued · transcribing · downloading · preparing · cleaning_voice · mixing_audio · rendering · finishing), phase (the engine's: download · prepare · voice · audio · encode · qa · upload, or null), progress (a percent, 0–100) and progress_fraction (0–1), eta_seconds (seconds left, never below 0) and estimate_seconds

errorstring nullable

Changes

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