Creative
Betacreative_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
Change the voice in my uploaded narration to the selected ElevenLabs voice and return the changed recording.