elevenlabs/eleven_v3 の API リファレンス。Elevenlabs から Comfy Router によって提供されます。
クイックスタート
Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk)を使用しています。cURL のスニペットは、同じ呼び出しを生の HTTP で行うものです。
Model ID: elevenlabs/eleven_v3
Endpoint: POST https://api.comfy.org/v2/models/elevenlabs/eleven_v3
- Wait for the result
- Queue and collect later
スキーマ
入力
string
デフォルト:"\"auto\""
テキスト正規化を 3 つのモードで制御します:
‘auto’ - システムがテキスト正規化を適用するかどうかを自動的に判断します
‘on’ - テキスト正規化は常に適用されます
‘off’ - テキスト正規化はスキップされます指定可能な値:
auto, on, offobject[]
必須
対話入力のリスト。各入力にはテキストと音声 ID が含まれ、音声に変換されます。
一意の音声 ID の最大数は 10 です。
string
必須
音声に変換するテキスト。
string
必須
生成に使用する音声の ID。
string
モデルと言語正規化に対して言語を強制するために使用される言語コード (ISO 639-1)。
指定された言語コードがモデルでサポートされていない場合、エラーが返されます。
string
使用されるモデルの識別子。このルートは
‘eleven_v3’ のみを受け付け、それ以外の値はリクエストが ElevenLabs に到達する前に
400 で拒否されます。
利用可能なセットを取得するために GET /v1/models を照会するという
ElevenLabs の上流の推奨は、1 つのモデルを提供するこのルートには
当てはまりません。
これはこのスキーマの
required リストに含まれていません。Comfy Router が
/v2/models/elevenlabs/{model} の {model} パスセグメントから
これを埋めるため、Router の呼び出し元は省略します。object[]
テキストに適用する発音辞書ロケーター (id, version_id) のリスト。
順番に適用されます。1 リクエストあたり最大 3 つのロケーターを使用できます。
string
必須
発音辞書の ID
string
必須
発音辞書のバージョン ID
integer
指定された場合、システムは決定論的にサンプリングするよう最善を尽くします。
同じシードとパラメータでリクエストを繰り返すと、同じ結果が返されるはずです。
0 以上 4294967295 以下の整数である必要があります。範囲:
0 から 4294967295object
対話生成を制御する設定
number
デフォルト:"0.5"
音声の安定性と、各生成間のランダム性を決定します。
低い値では音声の感情の幅が広がります。
高い値では、感情が限られた単調な音声になることがあります。形式:
doubleGET /v2/models/elevenlabs/eleven_v3/openapi.json で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に呼び出しを検証する対象となる同一のドキュメントです。
出力
string (binary)
生のオーディオバイト列。Content-Type とエンコーディングは要求された output_format に従い、ElevenLabs からそのまま転送されます。例はバイナリ本文のプレースホルダーであり、JSON や base64 ではありません。
出力
Router はこのモデルの出力スキーマを公開していません。例
入力
出荷前の確認
SDK はIdempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。