---
title: creative voice
description: 音声や動画の声を、別の声に変換します。
canonical_url: https://orchestor.io/docs/cli/creative/voice
markdown_url: https://orchestor.io/docs/cli/creative/voice.md
contentType: reference
---

# creative voice

`orc creative voice change` は、音声または動画の話し声を指定した声に置き換えるジョブを作成します。入力はアップロード済みファイルの `--file-id`、または公開 URL の `--audio-url` か `--video-url` で渡します。

声の ID は `orc creative tts voices list --family eleven` で確認します。詳しい入力と出力はボイスチェンジを参照してください。

## 使い方

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

*音声の声を変換し、完了まで待ちます。*

## サブコマンド

### `change`

録音の声を変更

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

#### 固有のオプション

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

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

型: `string`。任意。

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

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

Body field: file_id

型: `string`。任意。

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

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

Body field: audio_url; max 4096 chars

型: `string`。任意。

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

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

Body field: video_url; max 4096 chars

型: `string`。任意。

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

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

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

型: `number`。任意。

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

##### `--voice`

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

型: `string`。任意。

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

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

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

型: `string`。任意。

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

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

Body field: remove_background_noise

型: `string`。任意。

```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

型: `string`。任意。

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

## 使用例

### 背景ノイズを除去して変換します。

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

*背景ノイズを除去して変換します。*

## 必要な権限

CLI の認証（`orc auth login` または `ORCHESTOR_API_KEY`）と、対象 Workspace へのアクセスが必要です。 ジョブの作成には書き込み権限が必要です。

## グローバルオプション

`orc creative voice` では、次の[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を使用できます。

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%98%E3%83%AB%E3%83%97)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AF%E3%83%BC%E3%82%AF%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#%E5%87%BA%E5%8A%9B%E5%BD%A2%E5%BC%8F)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#%E5%80%A4%E3%81%A0%E3%81%91%E3%82%92%E5%87%BA%E5%8A%9B)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%B8%E3%81%AE%E5%87%BA%E5%8A%9B)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%9A%E3%83%BC%E3%82%B8%E9%80%81%E3%82%8A)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%81%AE%E4%BA%8B%E5%89%8D%E7%A2%BA%E8%AA%8D)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#%E7%A2%BA%E8%AA%8D%E3%81%AE%E7%9C%81%E7%95%A5)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B)
- [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#%E3%81%99%E3%81%B9%E3%81%A6%E3%81%AE%E3%83%9A%E3%83%BC%E3%82%B8%E3%82%92%E5%8F%96%E5%BE%97)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E6%99%82%E9%96%93)
- [`--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#%E8%AA%AD%E3%81%BF%E5%8F%96%E3%82%8A%E5%B0%82%E7%94%A8%E3%83%A2%E3%83%BC%E3%83%89)
- [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#%E5%A4%96%E9%83%A8%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%81%AE%E7%9B%AE%E5%8D%B0%E4%BB%98%E3%81%91)

各オプションの詳細と使用例は、[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を参照してください。

---

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