---
title: creative tts
description: List speech models and voices and create speech generation jobs.
canonical_url: https://orchestor.io/docs/en/cli/creative/tts
markdown_url: https://orchestor.io/docs/en/cli/creative/tts.md
contentType: reference
---

# 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

```bash title="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`

音声モデルを一覧表示

```bash title="terminal"
orc creative tts models list [options]
```

### `models get`

音声モデルを取得

```bash title="terminal"
orc creative tts models get <model-id> [options]
```

### `voices list`

声の候補を一覧表示

```bash title="terminal"
orc creative tts voices list [options]
```

#### Unique options

##### `--family`

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

Type: `string`. Required.

```bash title="terminal"
orc creative tts voices list --family <value>
```

##### `--purpose`

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

Type: `string`. Optional.

```bash title="terminal"
orc creative tts voices list --purpose <value>
```

### `generate`

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

```bash title="terminal"
orc creative tts generate [options]
```

#### Unique options

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

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

Type: `string`. Optional.

```bash title="terminal"
orc creative tts generate --idempotency-key <value>
```

## Examples

### List speech models.

```bash title="terminal"
orc creative tts models list --json
```

*List speech models.*

### Check a model's voice family.

```bash title="terminal"
orc creative tts models get sonic-3 --json
```

*Check a model's voice family.*

### Find a voice ID.

```bash title="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](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc creative tts`:

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