| You may read | The API says | What it is |
|---|---|---|
| Operation (long work you start and wait for) | Job | One unit of work with a status, a cost and a result |
| Artifact (a file you download) | Output | One entry of a project’s output list, with a presigned url |
| Composite run | localization job, with stages | Dub, lip-sync and on-screen as one job, each stage a child job |
| Segment generation take | SegmentClip | One voiced clip of one segment, stored under its job |
| Space, teamspace | Workspace | What a key is bound to. The web app calls it a space, and the MCP sign-in page a teamspace |
In this API, operation has another meaning: one call of the contract, named by its
operationId, such as createDub. So in these pages an operation is a call, and long work is a job.More terms
| Term | Meaning |
|---|---|
| Payer | The workspace owner, who is charged for all work in the workspace and whose plan applies |
| Acting user | The person who created the key; the key acts as this user |
| Plan feature, entitlement | Something the payer’s plan allows, such as lipsync_enhanced. See Capabilities and limits |
| Minutes | The main credit pool. Paid work is priced in minutes |
| Project credit | The credit pool that counts projects, not minutes. It is unlimited while the payer’s subscription is not terminated: projects.unlimited in the balance |
| Project | One media item localized into one target language |
| Segment | One timed line of a transcript, with its source and translation text |
| Speaker | One person detected in the media: id is SPEAKER_00, and label is the name people see, Speaker 1 |
| Dub, redub | Voicing and rebuilding the project’s video. createDub does both: full voices everything, changed_segments only what changed, and the default auto picks between them |
| Auto-dub | The dub a new project starts by itself after translation |
| Speech seconds | The total length of the segments that createDub or a segment generation voices, each from its start to its end. Both are priced on it, while an auto-dub is priced on the media’s duration: Prices and refunds |
| Free dubbing variant | free_dubbing: true on createProject, for a plan with free_languages. Its dub costs 0, so the project’s text is open from the start |
| Free lip-sync run | free_trial_run: true on createLipsync: the project’s one free run, which processes the first 60 seconds for 1 free lip-sync minute. See Lip-sync |
| Stage | One step of a localization run, dub, lipsync or onscreen, each a child job: the job’s stages. See One request for everything. A job’s stage is another thing: what the job is doing now, such as rendering |
| Meaning-first | The engine behind dubbing model v2; legacy is the engine behind v1 |
| Estimate | A free call that runs the checks of a paid call and returns its price |
total_minutes | The price an estimate returns, in minutes. You send it as the price cap |
| Price cap | expected_cost_minutes on a spending request: the most that request, and the spends it stores for later, may charge. A higher price answers 409 cost_changed. See Prices and refunds |
| Monthly caps | A key’s limits on what it spends in a UTC month, one on minutes and one on project credits. They are not the price cap. A request above one answers 403 token_spend_limit_exceeded. See Spend caps |
| Paid text | The transcript, segments, versions and subtitles of a project created through v3. They answer 409 dub_payment_required until a dub of the project is charged. See Paid text |