CLI

creative tts

orc creative tts lists speech synthesis models and voices and creates speech generation jobs. Voices are grouped by the model's voice_family; pass an id from tts voices list --family <family> as the request's voice.id.

tts generate reads its JSON input from --stdin. model, transcript and voice are the basic combination.

Usage

terminal
echo '{"model":"sonic-3","transcript":"Hello.","voice":{"id":"<voice-id>"}}' | orc creative tts generate --stdin --wait --json

Generate speech from a transcript and a voice, and wait for it.

Subcommands

models list

音声モデルを一覧表示

terminal
orc creative tts models list [options]

models get

音声モデルを取得

terminal
orc creative tts models get <model-id> [options]

voices list

声の候補を一覧表示

terminal
orc creative tts voices list [options]

Unique options

--family

モデルと声を組み合わせる系列。別系列の ID を混在させないでください。; enum: sonic|eleven|seed_audio|qwen|minimax|seed_speech

Type: string. Required.

terminal
orc creative tts voices list --family <value>
--purpose

voice_change と family=eleven を指定すると、アカウントで利用できる ElevenLabs の既定ボイスを返します。; enum: voice_change

Type: string. Optional.

terminal
orc creative tts voices list --purpose <value>

generate

モデルを選んで音声を生成

terminal
orc creative tts generate [options]

Unique options

--idempotency-key

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

Type: string. Optional.

terminal
orc creative tts generate --idempotency-key <value>

Examples

List speech models.

terminal
orc creative tts models list --json

List speech models.

Check a model's voice family.

terminal
orc creative tts models get sonic-3 --json

Check a model's voice family.

Find a voice ID.

terminal
orc creative tts voices list --family sonic --json

Find a voice ID.

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 tts:

For details and examples, see global options.