GET /api/v1/director/catalog under prices; this page explains how those numbers combine.
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_idorpackage— the packaging is held with the shot. When the clip is done it becomes its ownvideos/packagejob (packageJobId). If the clip stops, or the packaging never starts, its hold is given back andpackageSkippedsays 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.
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 returns429 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 returns400 invalid_request before anything is held, naming the field:
Packaging limits apply inside a
package object too, reported as e.g. package.tagline.
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.
