Skip to main content
Complete, copy-pasteable flows. Each one starts a job, polls it, and collects the result. Field-by-field detail for every endpoint is in the generated API reference; prices are explained in Billing and limits.

Before you start

A small poll helper used below. It waits until the job is done, failed or cancelled:
How to send values. Endpoints that take files use multipart/form-data (-F). In a form, true/false and numbers are read as such, and lists or objects go in as JSON text, e.g. -F 'product_pictures=[1]'. Endpoints without files also accept a JSON body. Any file field also takes a URL (-F song_url=https://…) or a path from your Pixio assets.

Music video from a song

1

Make a song (or bring your own)

36 credits. If it comes back shorter than asked, the job has durationShort; add sections to the lyrics for a longer song.
2

Quote it (free)

3

Shoot it

Same request without ?check=true:
Each finished section shows up in parts[] while the rest renders. A 60 s song from an idea is about 1,055 credits.
Want a cheaper look first? Add -F speed=draft (180 per section instead of 201), then render the same video at full quality with POST /director/videos/music/{id}/final (see the film flow below — it works the same way).

Retake one section

Didn’t like section 3? Re-shoot only that section as a new job; the original stays as it was.
One section at the source video’s price. For films the path is /director/videos/film/{id}/redo and the field is clip. qaIssues on the original names the part worth redoing.

Film: draft, then final

1

Draft

443 credits for 60 s from an idea as a draft.
2

Final

Renders the same written clips, pictures and seeds at full quality as a new job. Packaging and finishing carry over. The writing is not charged again.
460 credits for 60 s (4 clips × 115).

Commercial with a brand and packaging

1

Save the brand once (free)

2

Quote the commercial (free)

With variants=2 you’ll see perVersion and versions. Every version is held up front and billed like the first.
3

Make it

Send the same request without ?check=true. Poll the job; the other versions are in versionJobIds (poll each). When done, the main cut is output, and the 9:16, 1:1 and 15 s versions are in deliverables.
Already have a finished video? Brand it directly with POST /director/videos/package and job_id (or an uploaded video). Try colour filters first with the free GET /director/jobs/{id}/filter_preview?filter=all.

Documentary with a storyboard

1

Start with storyboard on

2

Wait for the storyboard

Poll until storyboard.waiting is true (the status stays running):
3

Fix a shot

25 credits, plus 16 with a note.
4

Approve and render

More in Storyboards.

A TV series episode

A 60 s episode is 775 credits. More in TV series.

Upscale, finish or fix faces afterwards

All three take the job_id of a finished job and start a new one:
A face fix holds 59 per section and charges only for sections it visibly changed (faceFixReport). It redraws one face per shot, so two-person shots change little.