---
title: creative_tts_generate
description: 接続先のワークスペースで、利用可能なモデルと声を指定して読み上げジョブを開始します。
canonical_url: https://orchestor.io/docs/mcp/tools/creative/creative_tts_generate
markdown_url: https://orchestor.io/docs/mcp/tools/creative/creative_tts_generate.md
contentType: reference
---

# creative_tts_generate

接続先のワークスペースで、利用可能なモデルと声を指定して読み上げジョブを開始します。

**操作:** 書き込み。読み取りと書き込みを許可する OAuth の認可が必要です。

## パラメーター

| パラメーター | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `body` | object | 必須 | 読み上げの入力。 |
| `body.model` | string | 必須 | `creative_tts_models_list` が返したモデル ID。 |
| `body.transcript` | string | 必須 | 読み上げる文章。 |
| `body.voice` | object | 必須 | 声の選択。 |
| `body.voice.id` | string | 必須 | モデルの `voice_family` を指定して `creative_tts_voices_list` で取得した声の ID。 |
| `body.output_format.container` | string | 任意 | モデルが対応していれば `mp3` または `wav` を指定できます。 |
| `body.mode` | string | 任意 | すぐにジョブを受け取るには `async` を指定します。 |
| `idempotency_key` | string | 必須 | 操作ごとに一意のキーを指定します。同じ入力で再試行する際は同じキーを使います。 |
| `approval_receipt` | string | 任意 | 計画とともに返る確認用の値。利用者が承認した後に指定します。 |

`creative_tts_models_get` で、声の系列、対応する設定、料金を確認できます。

最初の呼び出しは計画を返します。承認後に `approval_receipt` を添えて同じ入力を送信してください。ジョブは外部プロバイダーを呼び出し、クリエイティブクレジットを消費する場合があります。`data.job.id` を `creative_jobs_wait` に渡し、完了後に `creative_jobs_result` で成果物を取得します。

## 依頼例

```text
モデルが対応する声で「まもなく電車が到着します」と読み上げて、音声の URL を返してください。
```

[クリエイティブ](https://orchestor.io/docs/mcp/tools/creative.md) · [Tools](https://orchestor.io/docs/mcp/tools.md)

---

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