{"object":"montage","name":"Montage","summary":"Montage is Pixio’s AI film studio. It directs whole productions, not single clips: music videos cut to a song with lip sync (up to 6 minutes), short films and commercials (30 s to 7 min, in 15 s clips), plus explainers, short dramas, documentaries, TV series, single shots, images and songs, on three tiers (Montage Basic, Premium and Ultra, or a tier mix). It writes the treatment, keeps the cast and sets consistent from your reference pictures, shoots every section, checks the result, and lets you retake, lip fix or relip, edit with words, crop, upscale, finish, fix faces, add ad graphics, dub and package any part. It also studies any video or song, assembles clips, and runs audio tools: transcripts, stems, voice cleaning, dubbing, voiceover, mixing, sound effects and foley.","apiName":"Director API","whenToUse":["A music video for a song, with the artist from photos and lip sync.","A story film or a brand commercial longer than one clip, with the same people, product and places in every shot.","An ad delivered in several frame shapes with an end card, voiceover, captions and shorter cutdowns.","One 5–15 s shot from text, an image or references, at a known per-second price."],"makes":[{"kind":"music_video","endpoint":"POST /api/v1/director/videos/music","length":"The song’s length, up to 6:00, in 15 s sections","notes":"Send the song and pictures of the artist; lip sync follows the vocal. `speed: \"draft\"` for a cheaper look first, then `POST /api/v1/director/videos/music/{id}/final` renders the same video at full quality."},{"kind":"film","endpoint":"POST /api/v1/director/videos/film","length":"30 s – 7 min in 15 s clips","notes":"From an `idea` (the writer plans the clips) or your own `clips`. `voice_lock: true` keeps each character’s voice across the film. `speed: \"draft\"` first, then `POST /api/v1/director/videos/film/{id}/final` renders the same clips, pictures and seeds at full quality."},{"kind":"commercial","endpoint":"POST /api/v1/director/videos/film","length":"30 s – 7 min, plus cutdowns","notes":"`film_type: \"commercial\"` with an `ad_style` (11 formats, or `auto`), `product_pictures`, a saved `brand_id` and a `package` (end card, logo, packshot, a voiceover file, or `voiceover_text` read by one of 54 voices in 8 languages or cloned from your `voiceover_sample`, captions with `caption_style`, fine print, music bed that dips under dialogue, other `formats`, `cutdowns`). Extra shapes and cutdowns come back in `deliverables`."},{"kind":"explainer","endpoint":"POST /api/v1/director/videos/film","length":"30 s – 7 min in 15 s clips","notes":"`film_type: \"explainer\"` with an `idea`: a narrated vertical-video explainer. The AI writes the narration, a voice reads it (`package.voiceover_voice`, or your `voiceover_sample` with `voice_clone`), one shot per sentence, word-by-word captions, no end card."},{"kind":"long_take","endpoint":"POST /api/v1/director/videos/reference or videos/music","length":"20 – 60 s, one shot","notes":"`long_form: true`: ONE unbroken Montage Basic shot with no cuts (a walk, a dance, a singer coming toward the camera), rendered in 2–4 pieces that carry on from each other. On videos/reference send `duration` 20–60 and 1–9 `images` (`long_form_pieces` for your own prompt per 15 s piece); on videos/music `long_form_start` / `long_form_end` pick a 20–60 s part of the song. One place, at most 3 people. About 18 credits a second (1.7x at `megapixels: 1.0`) plus a writer round when the AI writes the pieces."},{"kind":"short_drama","endpoint":"POST /api/v1/director/videos/film","length":"30 s – 7 min in 15 s clips","notes":"`film_type: \"short_drama\"` with an `idea`: a vertical micro-drama episode (9:16 unless `aspect` is sent) with a hook in the first 3 s, one beat per clip, close-ups and reaction shots, short lines and no on-screen text. `drama_trope` picks the story engine (`auto`, `revenge`, `hidden_identity`, `rich_poor`, `betrayal`, `second_chance`, `contract_marriage`, `fated_mate`, `secret_baby`); `cliffhanger` (default true) ends on one. Also on `prompts/write` and `series/{id}/episodes`. Priced like any written film."},{"kind":"tv_series","endpoint":"POST /api/v1/director/series/{id}/episodes","length":"30 s – 7 min per episode","notes":"Save a show once with `POST /api/v1/director/series` (premise, look, cast pictures and voices, theme, title card; free), then make episodes from an `idea`. The writer gets the series and a recap of the earlier episodes; each finished episode saves its recap and teaches the show new faces and voices. Priced as a written film plus the recap and packaging."},{"kind":"documentary","endpoint":"POST /api/v1/director/videos/film","length":"30 s – 7 min in 15 s clips","notes":"`film_type: \"documentary\"` with an `idea`: a script in chapters with on-camera interviews, a deep narrator, one shot per line, title, chapter and name cards, subtitles and a score made for it. `doc_style` (dramatic, observational, investigative) and `interviews` (auto, few, none)."},{"kind":"single_shot","endpoint":"POST /api/v1/director/videos/{text|image|reference}","length":"5 – 15 s","notes":"Priced per second, fast or quality (billed as at least 8 s). Add `brand_id` / `package` to have it packaged as an ad too (`packageJobId`)."},{"kind":"image","endpoint":"POST /api/v1/director/images/{text|edit|reference}","length":null,"notes":"Set pictures, stills and edits."},{"kind":"song","endpoint":"POST /api/v1/director/music/generate","length":null,"notes":"A new song from a description and lyrics."}],"howAProductionRuns":[{"step":1,"title":"Pitch","description":"One line is enough: a song and a mood, or a story in a sentence."},{"step":2,"title":"Treatment","description":"Montage writes the treatment and the shot list. Or choose “I’ll write it” and bring your own."},{"step":3,"title":"Cast & sets","description":"Lock the people, props and places with set pictures and screen tests before anything rolls."},{"step":4,"title":"Greenlight","description":"Approve the plan and Montage shoots every section. Drafts come first, so you see the cut early."},{"step":5,"title":"Premiere","description":"Retake any section, fix or relip the lips, edit a moment with words, upscale, finish, fix faces, add graphics, dub and package it — then watch the whole piece."}],"agentQuickstart":["GET /api/v1/director/catalog: every endpoint, its fields and files, the named looks and the live price list.","Optional, free: POST /api/v1/director/prompts/check on your clip prompts, or add `?check=true` / `?dry_run=true` to videos/text, image, reference, music, film, remake, package, a series episode or jobs/{id}/edit for the report and the credit quote without starting.","Optional: POST /api/v1/director/prompts/write to have the writer plan film clips (or a 6–15 s ad) before you shoot.","POST the production (videos/music or videos/film). Credits are held up front and only the delivered parts are charged.","Poll GET /api/v1/director/jobs/{id} (or GET /api/v1/director/queue) until `status` is `done`; the output is copied into your assets.","Fix what is wrong without reshooting everything: videos/music/{id}/redo or videos/film/{id}/redo for one section, videos/lipfix (a 4–14 s window), videos/lipfix/auto or videos/relip for the lips, videos/edit to change a moment with words, then videos/upscale, videos/finish, videos/facefix (charged only for sections it visibly changed, see `faceFixReport`; `face` picks who: largest, smallest, left, right or centre), videos/graphics or videos/package on the finished job. videos/edit/analyze reports what is wrong and returns the fixes as ready requests.","Sharper Montage Basic: `megapixels: 1.0` on videos/reference, videos/film or videos/music (default 0.7) costs 1.7x per clip; `realism` (0–1) gives natural skin on Basic shots, films, music videos and series episodes.","Text has limits (prompt 8000, idea and story 4000, style 500…): longer text gets a 400 naming the field before anything is held; the catalog lists them as `maxLength`.","Want to see the shots first? Send `storyboard: true` with a film idea: it stops after writing with one still per shot (`storyboard.waiting`), lets you redraw any shot, and renders when you POST …/storyboard/approve."],"capabilities":[{"name":"Basic, Premium and Ultra","detail":"Three tiers, or mix them in one video"},{"name":"Lip sync","detail":"Mouths follow your vocal"},{"name":"Writes the treatment","detail":"Or “I’ll write it” yourself"},{"name":"Cast & sets","detail":"Set pictures and screen tests"},{"name":"TV series","detail":"Same cast, voices and story across episodes, with recaps"},{"name":"Commercials","detail":"Ad formats, product hero shots, end card, voiceover, captions and cutdowns"},{"name":"Explainers","detail":"Narrated vertical videos, one shot per sentence"},{"name":"Short dramas","detail":"Vertical micro-drama episodes that end on a cliffhanger"},{"name":"Long takes","detail":"One unbroken shot of 20 to 60 seconds"},{"name":"Documentaries","detail":"Chapters, interviews, a narrator and a score"},{"name":"Voices","detail":"Voice lock across a film; narration in 54 voices and 8 languages, or a cloned voice"},{"name":"Draft, then final","detail":"See the cut cheaply, then the same shots at full quality"},{"name":"Retakes","detail":"Re-shoot any one section"},{"name":"Upscale","detail":"1080p, fast or most detail"},{"name":"Finish","detail":"Grade, grain and loudness"},{"name":"Face fix","detail":"Section by section"},{"name":"Songs","detail":"Written from a description and lyrics"},{"name":"Images","detail":"From text, by edit or from references"},{"name":"Lip fix & Relip","detail":"Lips back on the vocal, nothing else touched"},{"name":"Montage Edit & Create","detail":"Change a moment with words, or make one from pictures"},{"name":"Montage Crop & Analyze","detail":"New shapes, trims and a QA report"},{"name":"Study & inspiration","detail":"Read any video or song, borrow its craft"},{"name":"Audio tools","detail":"Transcribe, stems, clean, dub, voiceover, mix"},{"name":"Sound effects & foley","detail":"Any sound you describe, or sound for your picture"},{"name":"Assemble","detail":"Your clips joined into one video"},{"name":"Ad graphics","detail":"Lower thirds, prices, buttons and end cards over the video"},{"name":"Dubbing & subtitles","detail":"Every cut in another language"}],"modalities":[{"name":"Text","support":"Input and output","detail":"Pitches, lyrics, clip prompts and ad scripts in; treatments, shot lists, narration and episode recaps out"},{"name":"Image","support":"Input and output","detail":"Up to 30 reference pictures in (9 on Basic); set pictures, stills and storyboards out"},{"name":"Audio","support":"Input and output","detail":"Your song, voice samples and any sound in; new songs, narration in 54 voices, dubs, stems, cleaned voices, transcripts, sound effects and foley out"},{"name":"Video","support":"Input and output","detail":"Reference and inspiration clips, or any finished video to edit, relip, crop, study or assemble in; music videos, films, commercials, episodes and shots out"}],"keyFacts":["Three tiers: Basic, Premium and Ultra","6:00 longest music video","7 min longest short film","TV series with the same cast every episode","Up to 30 reference pictures","5–15 s single shots","15 s sections, retaken one at a time","16:9, 9:16 and 1:1","8 productions at once per account"],"limits":[{"item":"Music video length","value":"Up to 6:00","note":"One song per video"},{"item":"Short film length","value":"30 s – 7 min","note":"In 15 s clips"},{"item":"TV episode length","value":"30 s – 7 min","note":"Up to 9 cast pictures and 3 voices each"},{"item":"Saved series","value":"50","note":"Per account"},{"item":"Single shot length","value":"5 – 15 s","note":"From text, an image or references"},{"item":"Long take length","value":"20 – 60 s","note":"One unbroken Montage Basic shot"},{"item":"Reference pictures","value":"30","note":"Premium and Ultra; 9 on Basic"},{"item":"Inspiration videos","value":"3","note":"Per film, up to 120 s each"},{"item":"Lip fix window","value":"4 – 14 s","note":"Or the whole video with Lip fix auto"},{"item":"Sound effect length","value":"Up to 30 s","note":"Up to 8 takes per request"},{"item":"Foley","value":"Up to 30 s","note":"Of video per request"},{"item":"Mix and master","value":"16 tracks","note":"Per mix"},{"item":"Ad graphics","value":"40","note":"Per video"},{"item":"Reference clips","value":"3","note":"Reference shots"},{"item":"Montage Basic sharpness","value":"0.7 or 1.0 MP","note":"1.0 MP is sharper and costs 1.7x per clip"},{"item":"Reference audio","value":"3","note":"Reference shots and films"},{"item":"Productions at once","value":"8","note":"Per account"}],"pricing":{"unit":"credits (1 credit = $0.01)","summary":[{"item":"Music video section","unit":"per 15 s, final · draft","credits":"201 · 180"},{"item":"Film clip","unit":"per 15 s, final · draft","credits":"115 · 73"},{"item":"Long take","unit":"per 30 s take, written for you","credits":"711"},{"item":"Writer round","unit":"treatment or script","credits":"151"},{"item":"Set picture · screen test","unit":"each","credits":"25 · 93"},{"item":"TV episode recap","unit":"per episode, on top of the film","credits":"76"},{"item":"Packaging","unit":"per second, 16 minimum","credits":"1.46"},{"item":"Song","unit":"each","credits":"36"},{"item":"Single shot","unit":"per second, fast · quality","credits":"4.73 · 7.57"},{"item":"Image","unit":"from","credits":"24"},{"item":"Upscale to 1080p","unit":"per 15 s, fast · most detail","credits":"13 · 71"},{"item":"Face fix","unit":"per 15 s section","credits":"59"},{"item":"Finish","unit":"per second, 16 minimum","credits":"1.46"},{"item":"Montage Premium · Ultra","unit":"quoted per video, shown before you start","credits":"Quoted"},{"item":"Lip fix · Relip · Edit · Create","unit":"quoted per request, 16 minimum","credits":"Quoted"},{"item":"Crop · Analyze · Study","unit":"quoted per request, 16 minimum","credits":"Quoted"},{"item":"Audio tools · Foley · Assemble · Dub","unit":"per second made, 16 minimum","credits":"1.46"},{"item":"Sound effects","unit":"per second made · from the library","credits":"0.2 · 16"},{"item":"Transcript · translated subtitles","unit":"each","credits":"16 · 16"},{"item":"Ad graphics","unit":"per second of video, 16 minimum","credits":"1.46"}],"prices":{"videoFastPerSecond":4.73,"videoQualityPerSecond":7.57,"musicSection":201,"musicSectionDraft":180,"filmClipFinal":115,"filmClipDraft":73,"writerRound":151,"adReview":76,"episodeRecap":76,"designedSets":6,"filmDesignedPictures":9,"setPicture":25,"factCheck":76,"remakeWatchPerClip":16,"upscaleMostDetail":71,"upscaleFast":13,"faceFix":59,"song":36,"finishPerSecond":1.46,"finishMinimum":16,"packagePerSecond":1.46,"packageMinimum":16,"score":36,"laughTrack":16,"storyboardNote":16,"visualQaFull":16,"visualQaLocal":4,"songAnalysis":16,"premiumPrompts":76},"notes":["Credits are held when a job starts and settled when it finishes; parts that never come back are not charged.","Extra work you ask for is priced in proportion: more `steps`, `vsa: false`, `finish`, visual QA, the ad review (`adReview`) and song analysis (`songAnalysis`).","Prompt checks, dry runs, brands, saved series, looks and filter previews are free.","A score made by the music model (packaging `score`, or a series theme) is charged per started 5 minutes (`score`); a laugh track adds `laughTrack`."]},"endpoints":[{"name":"Music video","path":"/api/v1/director/videos/music"},{"name":"Short film","path":"/api/v1/director/videos/film"},{"name":"TV series","path":"/api/v1/director/series/{id}/episodes"},{"name":"Packaging","path":"/api/v1/director/videos/package"},{"name":"Single shot","path":"/api/v1/director/videos/{text|image|reference}"},{"name":"Upscale, finish, face fix","path":"/api/v1/director/videos/{upscale|finish|facefix}"},{"name":"Images","path":"/api/v1/director/images/{text|edit|reference}"},{"name":"Lip fix · auto · Relip · Re-sync","path":"/api/v1/director/videos/{lipfix|lipfix/auto|relip|resync}"},{"name":"Montage Edit · Create · Crop · Analyze","path":"/api/v1/director/videos/edit/{…|create|crop|analyze}"},{"name":"Study a video or song","path":"/api/v1/director/understand/{video|audio}"},{"name":"Audio tools","path":"/api/v1/director/audio/{transcribe|stems|clean|master|voiceover|dub|sfx|foley}"},{"name":"Assemble","path":"/api/v1/director/videos/assemble"},{"name":"Ad graphics","path":"/api/v1/director/videos/graphics"},{"name":"Songs","path":"/api/v1/director/music/generate"},{"name":"Write clips","path":"/api/v1/director/prompts/write"},{"name":"Prompt check · free","path":"/api/v1/director/prompts/check"},{"name":"Jobs","path":"/api/v1/director/jobs/{id}"},{"name":"Catalog","path":"/api/v1/director/catalog"}],"links":{"guide":"https://beta.pixio.myapps.ai/api/v1/guide","openapi":"https://beta.pixio.myapps.ai/api/v1/openapi.json","catalog":"https://beta.pixio.myapps.ai/api/v1/director/catalog","voiceoverVoices":"https://beta.pixio.myapps.ai/api/v1/director/voiceover/voices","series":"https://beta.pixio.myapps.ai/api/v1/director/series","filters":"https://beta.pixio.myapps.ai/api/v1/director/filters","looks":"https://beta.pixio.myapps.ai/api/v1/director/looks","app":"https://beta.pixio.myapps.ai/home/director","page":"https://beta.pixio.myapps.ai/montage"},"auth":"Director calls need a Pixio API key: `Authorization: Bearer pxio_live_…`. This page is public."}