Skip to main content
Director bills in Pixio credits (1 credit = $0.01), from the same balance as the app. Prices are the same as in the app. The live price list is always at GET /api/v1/director/catalog under prices; this page explains how those numbers combine.
Get the exact quote for any request for free first: add ?check=true (or ?dry_run=true) to the start URL. Nothing is held or rendered. Video is expensive — a 60-second music video from an idea is about 1,055 credits ($10.55) — so quote before long jobs.

Hold, then settle

1

Held at the start

The full quote is reserved when the job starts. If your balance is short you get 402 insufficient_credits with requiredCredits, and nothing starts.
2

Settled once at the end

When the job finishes, the hold is settled exactly once: captured for what was delivered, and the rest given back. You are never charged more than was held.

Extra holds

Some requests hold more than one amount, so a short balance stops all of it up front:
  • Film variants — every version is held at the start, each at the single-version price. Each extra version is its own job (versionJobIds) and settles on its own.
  • A single shot with brand_id or package — the packaging is held with the shot. When the clip is done it becomes its own videos/package job (packageJobId). If the clip stops, or the packaging never starts, its hold is given back and packageSkipped says why.
  • face_fix: "auto" — after the video is done, sections whose faces drifted get a face fix as a separate job (faceFixJobId), held at that moment and billed like any face fix. If your balance is short then, the face fix is skipped, not charged.
  • Storyboard redraws and a made series theme are held when you ask, charged when the studio takes the work, and given back if it refuses.
Every settled job appears in your credits history and in GET /api/v1/credits/ledger.

Prices

All amounts in credits.

Single shots (videos/text, videos/image, videos/reference)

Formula: ceil(max(8, duration) × rate × stepsFactor × vsaFactor) — shots are billed as at least 8 seconds. stepsFactor is steps / 8 above 8 steps; vsaFactor is 1.8 with vsa: false.

Music videos (videos/music)

Formula: sections × ceil(sectionPrice × stepsFactor) + writer + sets + upscale + finish + visual QA + packaging. Sections are the song length divided into 15 s, rounded up (a remainder under 1/48 s joins the last section). stepsFactor uses a default of 8 steps, or 12 with lipsync: "sung_words".

Films (videos/film)

Formula: clips × clipPrice + writer + upscale + finish + visual QA + packaging + storyboard. Clips are duration / 15. Writer rounds are 1 for films up to 8 clips (2 minutes), otherwise 1 + ceil(clips / 4). Explainers and documentaries always include packaging; documentaries also include a score (36 per started 5 minutes).

Retakes and finals

TV series episodes (series/{id}/episodes)

An AI-written film of the episode’s length, plus 76 for the recap, plus packaging for the title card and theme (plus the series’ laugh track or a package.score when set). A 60 s episode is 775.

Post-processing

Packaging extras: a made score adds 36 per started 5 minutes; a laugh_track adds 16. Filters, looks, captions, fine print, a packshot and a typed voiceover cost nothing extra. A cutdown that isn’t at least 1 s shorter than the video is skipped and not charged.

Extras on films and music videos

Images

megapixels defaults to 4 and is priced between 0.5 and 16. image_model: "high" multiplies by 1.55 (text at default size → 38). Steps above 6 multiply by steps / 6 (12 steps → 48).

Songs and writing

Free

Prompt checks, ?check and ?dry_run quotes, brands, saving a series, looks, filter previews, the catalog, voice lists, job reads and stills. A series theme made for you (theme_auto or theme_brief) costs 36 when the series is saved.

Limits

Running jobs

At most 8 Director jobs queued or running at once per account. The ninth start returns 429 concurrency_limit with a Retry-After: 30 header — the request is rejected, not queued. This limit is separate from the /generate concurrency limit.

Saved things

Text

Text over its limit returns 400 invalid_request before anything is held, naming the field:
Packaging limits apply inside a package object too, reported as e.g. package.tagline.
Text is counted as sent: every line break counts as two characters. Text reaches the studio with line breaks as CRLF, so a 4,000-character idea with 40 line breaks counts as 4,040 and is refused. This applies to JSON and multipart bodies alike. Trim or join lines if you’re near a limit.

Files per request

Sending more than the maximum returns 400 invalid_request. Every file field accepts a multipart upload, a URL (<field>_url or <field>_urls), or a path from your own Pixio assets.

Lengths