Prepare create
multivoice.orders.prepare_createPrepares a paid dubbing, subtitles, transcription, or audiobook job and returns the exact price (commitment_amount). Does not start the paid job. Always show the human that amount and wait for confirmation in the MCP client before execute_create. Browser OAuth is one-time; do not open a browser again for each order. For types 4/5/7 take language_from/languages_to from get_create_options. For audiobook type 1 send nested book (no inspect). Types 2, 3 and 6 are MultiVoice Studio only.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| book | No | Book-only fields for order types 1, 2, and 3; do not send them for ordinary types. | |
| lip_sync | No | Optional language.id from get_create_options for lip-sync. | |
| currency_id | No | Optional currency code. Omit to use the account default from get_create_options. | |
| human_check | No | Optional: self, or a native-speaker review language: de, en, fr, lv, ru. Other languages are rejected. | |
| ui_language | No | Interface language. Blank is treated as en-US. | |
| languages_to | No | Target language.id values from get_create_options (e.g. ["lv"]). JSON array, not CSV. For dubbing (type 7) only de, en, fr, lv, ru. | |
| notify_email | No | Optional notification flag (true/false). Do not send an email address. | |
| project_name | No | Optional project name. Do not send a path or URL. | |
| language_from | No | Source language id from get_create_options languages[] (lowercase, e.g. ru not RU). Codes outside the list are rejected. | |
| order_type_id | No | Public order type id from the server. Take it from get_create_options. | |
| source_handle | No | Required opaque source handle from inspect for ordinary order types 4, 5, and 7; omit for audiobook order types 1, 2, and 3. | |
| speaker_labels | No | Optional speaker labels flag (true/false). | |
| translate_system | No | Optional. Omit — the server uses the current translation engine. | |
| human_translation_check | No | Optional human translation check languages: only de, en, fr, lv, ru. JSON array, not CSV. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | ||
| error | No | ||
| currency | No | ||
| quote_id | No | ||
| expires_at | No | ||
| action_code | No | ||
| description | No | ||
| approval_url | No | ||
| order_type_id | No | ||
| billing_effect | No | ||
| billing_timing | No | ||
| current_balance | No | ||
| available_balance | No | ||
| commitment_amount | No | ||
| remaining_per_day | No | ||
| expires_in_seconds | No | ||
| balance_gate_passed | No | ||
| confirmation_handle | No | ||
| remaining_per_month | No | ||
| remaining_per_operation | No | ||
| payload_contract_version | No | ||
| outstanding_mcp_commitment_amount | No |