CLI

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

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

録音の声を変更

terminal
orc creative voice change [options]

Unique options

--idempotency-key

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

Type: string. Optional.

terminal
orc creative voice change --idempotency-key <value>
--file-id

Body field: file_id

Type: string. Optional.

terminal
orc creative voice change --file-id <value>
--audio-url

Body field: audio_url; max 4096 chars

Type: string. Optional.

terminal
orc creative voice change --audio-url <value>
--video-url

Body field: video_url; max 4096 chars

Type: string. Optional.

terminal
orc creative voice change --video-url <value>
--duration-seconds

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

Type: number. Optional.

terminal
orc creative voice change --duration-seconds <value>
--voice

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

Type: string. Optional.

terminal
orc creative voice change --voice <value>
--voice-settings

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

Type: string. Optional.

terminal
orc creative voice change --voice-settings <value>
--remove-background-noise

Body field: remove_background_noise

Type: string. Optional.

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.

terminal
orc creative voice change --output-format <value>

Examples

Remove background noise while converting.

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 can be used with orc creative voice:

For details and examples, see global options.