curl --request POST \
--url https://api.rask.ai/v3/projects/{project_id}/localizations/estimate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"lipsync": {
"model": "legacy"
},
"onscreen": {
"ui_language": "en"
}
}
'{
"object": "estimate",
"action": "localization",
"project_id": "6f1c2b7e-8a4d-4e3f-9b5c-1d0a7e2f3c58",
"eligible": true,
"reasons": [],
"notices": [],
"costs": [
{
"credit_type": "minutes",
"minutes": 1,
"feature": "redub",
"charged_when": "at_stage_start",
"basis": {
"billable_seconds": 4,
"multiplier": null
}
},
{
"credit_type": "minutes",
"minutes": 4,
"feature": "lipsync_legacy",
"charged_when": "at_stage_start",
"basis": {
"billable_seconds": 240,
"multiplier": 1
}
},
{
"credit_type": "minutes",
"minutes": 2,
"feature": "onscreen",
"charged_when": "at_stage_start",
"basis": {
"billable_seconds": 240,
"multiplier": 0.5
}
}
],
"total_minutes": 7,
"total_projects": 0,
"balance_after": {
"minutes": 181,
"lipsync_free_minutes": null,
"projects": null
},
"spend_limit": {
"limit_minutes": 500,
"spent_minutes": 120,
"remaining_minutes": 380,
"limit_projects": null,
"spent_projects": 3,
"remaining_projects": null,
"resets_at": "2026-12-01T00:00:00Z"
},
"details": {
"action": "localization",
"stages": [
{
"name": "dub",
"will_run": true,
"minutes": 1,
"not_run_reason": null
},
{
"name": "lipsync",
"will_run": true,
"minutes": 4,
"not_run_reason": null
},
{
"name": "onscreen",
"will_run": true,
"minutes": 2,
"not_run_reason": null
}
],
"dub": {
"action": "dub",
"mode_requested": "auto",
"mode_applied": "changed_segments",
"segments_to_voice": 1,
"changed_speech_seconds": 3.4,
"billable_minutes": 1,
"pricing_rule": "changed_speech",
"engine": "meaning_first",
"segment_ids_to_voice": [
"5f0e2c7a-1b3d-4e6f-8a9c-2d4e6f8a0b11"
],
"reused_clip_segment_ids": [
"8b3d1e9f-6a2c-4d7e-b5f1-3c9e7a1d5b22"
],
"assembly_anchor_segment_id": null,
"text_adaptation": "as_written"
},
"final_output_kind": "localized_video",
"resume_job_id": null
}
}Estimate a dub, lip-sync and on-screen run
Runs every check of createLocalization without writing and returns an Estimate.
curl --request POST \
--url https://api.rask.ai/v3/projects/{project_id}/localizations/estimate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"lipsync": {
"model": "legacy"
},
"onscreen": {
"ui_language": "en"
}
}
'{
"object": "estimate",
"action": "localization",
"project_id": "6f1c2b7e-8a4d-4e3f-9b5c-1d0a7e2f3c58",
"eligible": true,
"reasons": [],
"notices": [],
"costs": [
{
"credit_type": "minutes",
"minutes": 1,
"feature": "redub",
"charged_when": "at_stage_start",
"basis": {
"billable_seconds": 4,
"multiplier": null
}
},
{
"credit_type": "minutes",
"minutes": 4,
"feature": "lipsync_legacy",
"charged_when": "at_stage_start",
"basis": {
"billable_seconds": 240,
"multiplier": 1
}
},
{
"credit_type": "minutes",
"minutes": 2,
"feature": "onscreen",
"charged_when": "at_stage_start",
"basis": {
"billable_seconds": 240,
"multiplier": 0.5
}
}
],
"total_minutes": 7,
"total_projects": 0,
"balance_after": {
"minutes": 181,
"lipsync_free_minutes": null,
"projects": null
},
"spend_limit": {
"limit_minutes": 500,
"spent_minutes": 120,
"remaining_minutes": 380,
"limit_projects": null,
"spent_projects": 3,
"remaining_projects": null,
"resets_at": "2026-12-01T00:00:00Z"
},
"details": {
"action": "localization",
"stages": [
{
"name": "dub",
"will_run": true,
"minutes": 1,
"not_run_reason": null
},
{
"name": "lipsync",
"will_run": true,
"minutes": 4,
"not_run_reason": null
},
{
"name": "onscreen",
"will_run": true,
"minutes": 2,
"not_run_reason": null
}
],
"dub": {
"action": "dub",
"mode_requested": "auto",
"mode_applied": "changed_segments",
"segments_to_voice": 1,
"changed_speech_seconds": 3.4,
"billable_minutes": 1,
"pricing_rule": "changed_speech",
"engine": "meaning_first",
"segment_ids_to_voice": [
"5f0e2c7a-1b3d-4e6f-8a9c-2d4e6f8a0b11"
],
"reused_clip_segment_ids": [
"8b3d1e9f-6a2c-4d7e-b5f1-3c9e7a1d5b22"
],
"assembly_anchor_segment_id": null,
"text_adaptation": "as_written"
},
"final_output_kind": "localized_video",
"resume_job_id": null
}
}total_minutes, the details of the dub stage, eligibility with reasons and balance_after. With resume_job_id it prices resuming that failed run: stages that succeeded cost 0. When the plan would trim the lip-sync and on-screen is also ordered, eligible is false with the reason localization_combination_not_supported. A stage with a current result costs 0 (not_run_reason): a dub with nothing to voice, a paid lip-sync of the same model (a free run does not count), an on-screen run over the same source. A dub that runs makes the later stages run and cost too. details.dub.assembly_anchor_segment_id names the segment voiced again when all changed segments have a current clip (createDub).
When to use: before createLocalization or resumeJob; send total_minutes as expected_cost_minutes.
Side effects: None.
Cost: Free. Does not need credits:spend.
Idempotency: no side effects; an Idempotency-Key is accepted and ignored, so every call is fresh.
Required scopes: dubbing:write
Errors: job_not_found (404)Authorizations
API key from Settings -> API keys, sent as Authorization: Bearer <key> (SDK environment variable RASK_API_KEY). Bound to one workspace and one acting user. Operations list the scopes they need (OpenAPI 3.1 scopes on a bearer scheme).
Scopes
Headers
Accepted and ignored: this operation has no side effects and stores nothing.
1 - 255^[\x20-\x7E]+$Path Parameters
Project id (from createProject or listProjects).
64Body
Same body as createLocalization, or resume_job_id to price resuming a failed run.
The dub stage; omit for mode auto.
Show child attributes
Show child attributes
Run lip-sync after the dub.
Show child attributes
Show child attributes
Translate on-screen text last, over the lip-synced video when lip-sync is ordered.
Show child attributes
Show child attributes
Price resuming this failed localization job of the project (resumeJob) instead of a new run; the stage fields are then ignored.
64Accepted and ignored, so the action's body can be sent unchanged.
0 <= x <= 100000Response
OK: Estimate.
A side-effect-free quote produced by the action's own checks. Transient: carries object, no id.
Always estimate.
estimate The action an estimate prices. Discriminator of details.
create_project: createProjectcreate_project_copies: createProjectCopiesdub: createDublipsync: createLipsynconscreen: createOnscreensegment_generation: generateSegmentslocalization: createLocalization, resumeJob
create_project, create_project_copies, dub, lipsync, onscreen, segment_generation, localization The project; null for project creation.
True when the action would start now, balance, plan, scopes and key limits included.
Blocking reasons (the action's error codes, plus insufficient_scope, token_spend_limit_exceeded, workspace_access_suspended).
Show child attributes
Show child attributes
Non-blocking notices (dubbing_model_overridden, trial_processing_window, meaning_first_disabled, voice_fallback, assembly_anchor_voiced, wider_voice_setup, clips_not_reusable).
Show child attributes
Show child attributes
Cost lines.
A line of an estimate: a union on credit_type.
- Option 1
- Option 2
Show child attributes
Show child attributes
Sum of minute lines (any minute pool): send this as expected_cost_minutes.
x >= 0Sum of project-credit lines (0 when unlimited).
x >= 0Balances after the action.
Show child attributes
Show child attributes
The calling key's monthly caps; null when the key has neither cap.
Show child attributes
Show child attributes
Per-action details; action mirrors Estimate.action.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
Show child attributes
Show child attributes