---
title: creative voice
description: Convert the voice in audio or video to another voice.
canonical_url: https://orchestor.io/docs/en/cli/creative/voice
markdown_url: https://orchestor.io/docs/en/cli/creative/voice.md
contentType: reference
---

# creative voice

`orc creative voice change` creates a job that replaces the spoken voice in audio or video with the voice you choose. Pass the input as an uploaded file's `--file-id`, or a public `--audio-url` or `--video-url`.

Find voice IDs with `orc creative tts voices list --family eleven`. See Voice change for the inputs and output.

## Usage

```bash title="terminal"
orc creative voice change --audio-url https://example.com/input.mp3 --voice '{"id":"<voice-id>"}' --wait --json
```

*Change the voice in an audio clip and wait for it.*

## Subcommands

### `change`

録音の声を変更

```bash title="terminal"
orc creative voice change [options]
```

#### Unique options

##### `--idempotency-key`

同じ入力の再送で同じジョブを返すキー。1〜255 文字の印字可能 ASCII。同じキーで異なる入力を送ると 409 です。

Type: `string`. Optional.

```bash title="terminal"
orc creative voice change --idempotency-key <value>
```

##### `--file-id`

Body field: file_id

Type: `string`. Optional.

```bash title="terminal"
orc creative voice change --file-id <value>
```

##### `--audio-url`

Body field: audio_url; max 4096 chars

Type: `string`. Optional.

```bash title="terminal"
orc creative voice change --audio-url <value>
```

##### `--video-url`

Body field: video_url; max 4096 chars

Type: `string`. Optional.

```bash title="terminal"
orc creative voice change --video-url <value>
```

##### `--duration-seconds`

入力の再生秒数。料金はサーバーの実測値で決まります。

Type: `number`. Optional.

```bash title="terminal"
orc creative voice change --duration-seconds <value>
```

##### `--voice`

(required) Body field: voice; (JSON object, e.g. '{"custom_id":"x"}')

Type: `string`. Optional.

```bash title="terminal"
orc creative voice change --voice <value>
```

##### `--voice-settings`

Body field: voice_settings; (JSON object, e.g. '{"custom_id":"x"}')

Type: `string`. Optional.

```bash title="terminal"
orc creative voice change --voice-settings <value>
```

##### `--remove-background-noise`

Body field: remove_background_noise

Type: `string`. Optional.

```bash title="terminal"
orc creative voice change --remove-background-noise <value>
```

##### `--output-format`

音声出力の形式。PCM は WAV で返します。動画の出力形式は入力クリップに合わせます。; enum: mp3_44100_128|mp3_44100_192|pcm_8000|pcm_16000|pcm_22050|pcm_24000|pcm_44100|pcm_48000

Type: `string`. Optional.

```bash title="terminal"
orc creative voice change --output-format <value>
```

## Examples

### Remove background noise while converting.

```bash title="terminal"
orc creative voice change --file-id <file-id> --voice '{"id":"<voice-id>"}' --remove-background-noise --wait
```

*Remove background noise while converting.*

## Permissions

Requires CLI authentication (`orc auth login` or `ORCHESTOR_API_KEY`) and access to the target Workspace. Creating a job requires write access.

## Global Options

The following [global options](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc creative voice`:

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#help)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#workspace)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#output-format)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#raw-output)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#file-output)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#pager)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#dry-run)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#confirmation)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#all-pages)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#request-timing)
- [`--wait`](https://orchestor.io/docs/cli/global-flags.md)
- [`--timeout`](https://orchestor.io/docs/cli/global-flags.md)
- [`--poll-interval`](https://orchestor.io/docs/cli/global-flags.md)
- [`--readonly`](https://orchestor.io/docs/cli/global-flags.md#read-only-mode)
- [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#untrusted-content-wrapping)

For details and examples, see [global options](https://orchestor.io/docs/cli/global-flags.md).

---

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