---
title: creative_audio_detach
description: Creative フラグが有効な接続先ワークスペースで、保存済み動画から音声を抽出します。
canonical_url: https://orchestor.io/docs/mcp/tools/creative/creative_audio_detach
markdown_url: https://orchestor.io/docs/mcp/tools/creative/creative_audio_detach.md
contentType: reference
---

# creative_audio_detach

Creative フラグが有効な接続先ワークスペースで、保存済み動画から音声を抽出します。

**操作** 書き込み。

## パラメーター

| パラメーター | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `body` | object | はい | 動画の処理設定。 |
| `body.video_url` | string | はい | 同じワークスペースの保存済み動画 URL。最大 100 MB。 |
| `body.format` | string | いいえ | 出力形式。wav または mp3。既定値は wav。 |
| `body.range` | object | いいえ | 開始位置と任意の終了位置を秒で指定します。省略すると全体を抽出します。 |
| `body.channels` | string | いいえ | source で元のチャンネル構成を保持し、mono でモノラルへ変換します。 |
| `body.sample_rate` | integer | いいえ | 出力のサンプルレート。16000、44100、48000 Hz。 |
| `body.mode` | string | いいえ | async ならジョブ ID を即時に受け取れます。sync または subscribe は上限付き待機、webhook は終端通知です。 |
| `body.wait_timeout_seconds` | integer | いいえ | sync または subscribe の待機時間。0〜30 秒。 |
| `body.webhook_url` | string | いいえ | 終端通知を受け取る公開 HTTPS URL。 |
| `body.project_id` | string | いいえ | 同じワークスペース内の保存先プロジェクト ID。 |
| `body.metadata` | object | いいえ | ジョブに保存する呼び出し元の補足情報。 |
| `idempotency_key` | string | はい | 同じリクエストの再試行時に同じキーを使います。 |

入力は最大 1,800 秒、出力は最大 900 秒です。音声トラックがない動画はジョブが失敗します。

`data.job.id` を `creative_jobs_wait` に渡し、完了後に `creative_jobs_result` で出力を取得します。

## プロンプト例

```text
アップロード済みの動画から 16000 Hz のモノラル WAV を抽出し、音声 URL を返してください。
```

[Creative](https://orchestor.io/docs/mcp/tools/creative.md) · [ツール](https://orchestor.io/docs/mcp/tools.md)

---

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