---
title: creative_voice_change
description: Start a voice change job for an uploaded recording in the connected workspace.
canonical_url: https://orchestor.io/docs/en/mcp/tools/creative/creative_voice_change
markdown_url: https://orchestor.io/docs/en/mcp/tools/creative/creative_voice_change.md
contentType: reference
---

# creative_voice_change

Start a voice change job for an uploaded recording in the connected workspace.

**Operation:** Write. Requires read-and-write OAuth consent.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `body` | object | Yes | Voice change input. |
| `body.file_id` | string | No | ID of the uploaded file. Supply exactly one of `file_id`, `audio_url`, or `video_url`. |
| `body.audio_url` | string | No | URL for an audio upload in the same workspace. |
| `body.video_url` | string | No | URL for a video upload with an audio track in the same workspace. |
| `body.voice` | object | Yes | Target voice selection. |
| `body.voice.id` | string | Yes | Voice ID from `creative_tts_voices_list` with ElevenLabs voice change filters. |
| `idempotency_key` | string | Yes | Use a unique key per action. Reuse it to retry identical input. |
| `approval_receipt` | string | No | Receipt returned with the plan. Supply it after user confirmation. |

The server measures source duration and accepts recordings from 1 to 300 seconds. A video result includes the video and the changed audio.

The first call returns a plan. After confirmation, resubmit the same input with its `approval_receipt`. The job calls an external provider and can consume Creative credits. Pass `data.job.id` to `creative_jobs_wait`, then retrieve the output with `creative_jobs_result`.

## Sample prompt

```text
Change the voice in my uploaded narration to the selected ElevenLabs voice and return the changed recording.
```

[Creative](https://orchestor.io/docs/en/mcp/tools/creative.md) · [Tools](https://orchestor.io/docs/en/mcp/tools.md)

---

[Documentation index](https://orchestor.io/docs/llms.txt)
