> ## Documentation Index > Fetch the complete documentation index at: https://dripart-chore-mintlify-theme-mint.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Comfy Router で Eleven Sfx V2 を使う > Comfy Router 経由で elevenlabs/eleven_sfx_v2 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。 `elevenlabs/eleven_sfx_v2` の APIリファレンス。Comfy Router が Elevenlabs から提供します。 ## クイックスタート [Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python、TypeScript、Swift のスニペットは Comfy SDK（`pip install comfy-sdk`、`npm install @comfyorg/sdk`、および [`ComfySwiftSDK`](https://github.com/Comfy-Org/comfy-swift-sdk) Swift パッケージ）を使用しています。cURL のスニペットは、同じ呼び出しを生の HTTP で実行するものです。 **モデルID:** `elevenlabs/eleven_sfx_v2` **エンドポイント:** `POST https://api.comfy.org/v2/models/elevenlabs/eleven_sfx_v2` ```python Python theme={null} from comfy_sdk import Comfy # 環境変数から COMFY_API_KEY を読み取ります。 # SDK は冪等性キーを自動的に作成し、自動リトライのために再利用します。 with Comfy() as client: result = client.models.run( "elevenlabs/eleven_sfx_v2", { "duration_seconds": 5, "text": "A distant rumble of thunder rolling across a valley.", }, ) print(result) ``` ```typescript TypeScript theme={null} import { comfy } from "@comfyorg/sdk"; // 環境変数から COMFY_API_KEY を読み取ります。 // SDK は冪等性キーを自動的に作成し、自動リトライのために再利用します。 const { data } = await comfy.models.run("elevenlabs/eleven_sfx_v2", { duration_seconds: 5, text: "A distant rumble of thunder rolling across a valley.", }); console.log(data); ``` ```swift Swift theme={null} import Foundation import ComfySwiftSDK // 環境変数から COMFY_API_KEY を読み取ります。 // SDK は呼び出しごとに冪等性キーを生成し、自動リトライのために再利用します。 let client = ComfyCloudClient(apiKey: ProcessInfo.processInfo.environment["COMFY_API_KEY"]!) let result = try await client.models.run( "elevenlabs/eleven_sfx_v2", input: [ "duration_seconds": 5, "text": "A distant rumble of thunder rolling across a valley.", ] ) print(result.output) ``` ```bash cURL theme={null} curl https://api.comfy.org/v2/models/elevenlabs/eleven_sfx_v2 \ -H "X-API-Key: $COMFY_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d "{\"duration_seconds\": 5, \"text\": \"A distant rumble of thunder rolling across a valley.\"}" ``` 同じボディを `POST https://api.comfy.org/v2/models/elevenlabs/eleven_sfx_v2/requests` に送信します。Router は実行が受け付けられ次第 `201` と `request_id` を返し、結果は準備が整った時点で、このプロセスからでも別のプロセスからでも取得できます。ステータス、キャンセル、結果の取得の詳細は [キュー配信](/ja/development/comfy-router/queue) を参照してください。 ```python Python theme={null} from comfy_sdk import Comfy # 環境変数から COMFY_API_KEY を読み取ります。 # 各 submit() 呼び出しは独自の Idempotency-Key を生成し、自動再試行時にそれを再利用します。 with Comfy() as client: handle = client.models.submit( "elevenlabs/eleven_sfx_v2", { "duration_seconds": 5, "text": "A distant rumble of thunder rolling across a valley.", }, ) print("request_id:", handle.request_id) # モデル ID と合わせて、別のプロセスが必要とするすべてのもの # リクエストが完了するまでポーリングし、サーバーが指定する Retry-After の秒数だけ待機します。 for update in handle.iter_events(): print(update.status, update.queue_position) # プロバイダー自身のペイロード。models.run() が返す値と同じです。 # 失敗またはキャンセルされたリクエストは、ここで型付きの Router エラーを発生させます。 result = handle.get() print(result) ``` ```typescript TypeScript theme={null} import { comfy } from "@comfyorg/sdk"; // 環境変数から COMFY_API_KEY を読み取ります。 // 各 submit() 呼び出しは独自の Idempotency-Key を生成し、自動再試行時にそれを再利用します。 const handle = await comfy.models.submit("elevenlabs/eleven_sfx_v2", { duration_seconds: 5, text: "A distant rumble of thunder rolling across a valley.", }); console.log("requestId:", handle.requestId); // モデル ID と合わせて、別のプロセスが必要とするすべてのもの // リクエストが完了するまでポーリングし、サーバーが指定する Retry-After の秒数だけ待機します。 for await (const update of handle.events()) { console.log(update.status, update.queuePosition); } // models.run() が返すのと同じ結果。失敗またはキャンセルされたリクエストはここで reject されます。 const result = await handle.get(); console.log(result.data); ``` ```swift Swift theme={null} import Foundation import ComfySwiftSDK // 環境変数から COMFY_API_KEY を読み取ります。 // 各 submit() 呼び出しは独自の Idempotency-Key を生成し、自動再試行時にそれを再利用します。 let client = ComfyCloudClient(apiKey: ProcessInfo.processInfo.environment["COMFY_API_KEY"]!) let handle = try await client.models.submit( "elevenlabs/eleven_sfx_v2", input: [ "duration_seconds": 5, "text": "A distant rumble of thunder rolling across a valley.", ] ) print("requestId:", handle.requestId) // モデル ID と合わせて、別のプロセスが必要とするすべてのもの // リクエストが完了するまでポーリングし、サーバーが指定する Retry-After の秒数だけ待機します。 for try await update in handle.events() { print(update.state.rawValue, update.queuePosition.map(String.init) ?? "unknown") } // プロバイダー自身のペイロード。models.run() が返す値と同じです。 // 失敗またはキャンセルされたリクエストは、ここで型付きの Router エラーをスローします。 let result = try await handle.result() print(result.output) ``` ```bash cURL theme={null} # 1. 送信します。Router は request_id、status_url、response_url、cancel_url を含む 201 を返します。 curl https://api.comfy.org/v2/models/elevenlabs/eleven_sfx_v2/requests \ -H "X-API-Key: $COMFY_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d "{\"duration_seconds\": 5, \"text\": \"A distant rumble of thunder rolling across a valley.\"}" # 2. ステータスが COMPLETED になるまでポーリングし、各レスポンスが指定する Retry-After 秒だけ待機します。 REQUEST_ID="" curl -i https://api.comfy.org/v2/models/elevenlabs/eleven_sfx_v2/requests/$REQUEST_ID/status \ -H "X-API-Key: $COMFY_API_KEY" # 3. 取得します。モデルのネイティブ出力の場合は 200、まだ実行中の場合はステータスボディとともに 202 を返します。 curl https://api.comfy.org/v2/models/elevenlabs/eleven_sfx_v2/requests/$REQUEST_ID \ -H "X-API-Key: $COMFY_API_KEY" ``` ## スキーマ ### 入力 生成されるサウンドの長さ（秒）。 0.5 以上、30 以下である必要があります。 このルートでは必須です。フィールドが null の場合に最適な長さを推測する上流の ElevenLabs API とは異なり、このルートは省略されたリクエストを 400 "Duration is required" で拒否します。 このフィールドが nullable のままであるのは、明示的な null が整形式のドキュメントとなるようにするためだけであり、それでも拒否されます。 この値が、リクエストの課金対象となる量です。 範囲: `0.5` から `30` 形式: `double` 滑らかにループするサウンドエフェクトを作成するかどうか。 ElevenLabs のドキュメントでは、これは 'eleven\_text\_to\_sound\_v2' モデルでのみ利用可能とされていますが、このルートはそのモデルを受け付けません（model\_id を参照）。そのため、ここでは効果がない可能性があります。 サウンド生成に使用するモデル ID。このルートは 'eleven\_sfx\_v2' のみを受け付け、それ以外の値はリクエストが ElevenLabs に到達する前に 400 で拒否されます。「eleven\_sfx\_v2」は、ElevenLabs が「eleven\_text\_to\_sound\_v2」と呼ぶモデルに対する Comfy の ID です。プロキシは転送するボディをこのベンダー表記に書き換えます。これは ElevenLabs 自身の enum が要求するもので（「eleven\_sfx\_v2」は 422 で拒否されます）、呼び出し元がベンダー ID を送ることはありません。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/elevenlabs/\{model} の `{model}` パスセグメントからこれを設定するためであり、Router の呼び出し元はこれを省略します。 prompt influence を高くすると、生成結果がプロンプトに沿いやすくなる一方で、生成のばらつきが小さくなります。 0 から 1 の間の値である必要があります。デフォルトは 0.3 です。 範囲: `0` から `1` 形式: `double` サウンドエフェクトに変換されるテキスト。 Router が `GET /v2/models/elevenlabs/eleven_sfx_v2/openapi.json` で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に呼び出しを検証する対象となるドキュメントと同じものです。 ### 出力 生のオーディオバイト列。Content-Type とエンコーディングは要求された output\_format に従い、ElevenLabs からそのまま転送されます。例はバイナリ本文のプレースホルダーであり、JSON や base64 ではありません。 ## 例 ### 入力 ```json theme={null} { "duration_seconds": 5, "text": "A distant rumble of thunder rolling across a valley." } ``` ### 出力 バイナリボディ: JSON ドキュメントではなく生のバイト列で、`*/*` として返されるため、表示できる JSON 例はありません。レスポンスの `Content-Type` とエンコーディングは、上記の出力スキーマで説明したとおり、リクエストに従います。 ## 出荷前の確認 SDK は `Idempotency-Key` を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。 リクエストが失敗すると、Router は理由を説明する `X-Comfy-Error-Type` レスポンスヘッダーを送信します。`422` は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味し、`413` はリクエスト本文が Router の受け入れ可能なサイズを超えていたことを意味します。生成されたアセットは [結果 URL の有効期限](/ja/development/comfy-router/reference#結果アセット) があるため、早めにダウンロードしてください。 上記のフィールド説明に記載されているサイズ制限は、プロバイダーの仕様から引用した、そのフィールドに対するプロバイダー自身の上限です。Router はリクエスト本文全体に対して別の上限を適用し、base64 エンコードされたメディアもこれにカウントされます。[リクエスト本文のサイズ](/ja/development/comfy-router/limitations) を参照してください。 このページは、Comfy Router 経由で呼び出す 1 つのパートナーモデルについて説明しています。同じ `comfy-sdk` / `@comfyorg/sdk` パッケージには、Comfy Cloud 上で ComfyUI のワークフローグラフ全体を実行するための 2 つ目のクライアントも含まれています: `Comfy(api_key=...)` / `new Comfy({ apiKey })`、および `client.workflows`、`client.assets`、`client.jobs`。[Comfy SDKs](/ja/development/api-development/sdks) を参照してください。 認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。 モデルの検出、バリデーションエラー、リトライ、課金。 Router が現在対応していないことと、代替手段。