アップロードしたファイル（`file`）またはソースURL（`source_url`）から吹き替えプロジェクトを作成します。
ソースの取得前であっても、プロジェクトレコードが作成されるとすぐに返されます。プロジェクトは`queued`で開始し、ソースの文字起こしが完了すると`ready`になります。必要な言語ごとに言語ターゲットを追加するか、`target_language`を渡して最初のターゲットをここでキューに追加します。
プロジェクトの作成には最低1言語分の料金がかかります。出力が作成される前に、少なくとも1言語分の吹き替え料金が請求されます。この料金は最初の言語ターゲット分の前払いです。最初に追加するターゲット、または`target_language`でキューに追加したターゲットで消費され、追加の各言語には別途料金がかかります。
長いソースでは準備に数分かかる場合があるため、ポーリングする代わりに`webhook_ids`を渡して、プロジェクトが`ready`または`failed`になった際に通知を受け取ることをおすすめします。
リクエスト This endpoint expects a multipart form with multiple files.
file file オプション
吹き替え対象のソースメディアファイル。最大3GiBのオーディオまたはビデオファイルです。これまたはsource_urlのいずれか一方を指定してください。
source_url string or null オプション
サーバー側でソースメディアを取得する公開HTTP(S) URL。アップロードと同じサイズおよび形式の制限が適用されます。これまたはfileのいずれか一方を指定してください。
reference string or null オプション
プロジェクトを識別するための任意の自由形式文字列（最大500文字）です。入力どおりに保存および返却され、吹き替えには影響しません。
source_language string or null オプション
ソースメディアのBCP-47言語タグです。文字起こしモデルがサポートする言語である必要があります。文字起こしは言語ごとに行われるため、リージョンまたはスクリプトのサブタグは無視されます。省略すると自動検出されます。
model_id enum or string or null オプション
このプロジェクトのすべての対象言語の吹き替えに使用する吹き替えモデル（`dubbing_v1`または`dubbing_v2`）。デフォルトは`dubbing_v2`です。作成時に固定されます。ソースはこのモデル向けに準備されるため、後からプロジェクト単位でも個別の対象言語単位でも変更できません。
keyterms list of strings オプション
文字起こしと翻訳で優先するキーターム（例：プロダクト名やブランド名）です。最大1,000件で、各タームは最大50文字かつ5単語までです。文字`<>{}[]\`は使用できません。タームはトリミングされ、重複が除去されます。タームごとにフィールドを1回繰り返すか、単一のJSON配列を渡してください。
webhook_ids list of strings オプション
このプロジェクトの進行に応じて通知するワークスペースWebhookのID。ポーリングの代替手段であり、推奨されます。各Webhookは、プロジェクトに対して`dubbing_project_ready`または`dubbing_project_failed`イベントを受信し、配下の各言語に対して`dubbing_language_completed`または`dubbing_language_failed`イベントを受信します。`dubbing_language_completed`には出力のダウンロードURLが含まれます。IDは最大3件で、いずれもワークスペースで事前に設定されている必要があります。作成方法と署名の検証方法については、[Webhooks](https://elevenlabs.io/docs/eleven-api/resources/webhooks)を参照してください。IDごとにフィールドを1回ずつ繰り返すか、単一のJSON配列またはカンマ区切り文字列を渡します。配信はベストエフォートで繰り返される場合があるため、イベントは冪等に処理することをおすすめします。
target_language string or null オプション
任意のショートカットです。このBCP-47言語の言語ターゲットも作成し、プロジェクトの準備が完了すると開始されるようキューに追加します。これはプロジェクトを作成してから1つの言語ターゲットを作成するのと同等です。[吹き替えモデルがサポートする言語](https://elevenlabs.io/docs/help-center/product/dubbing/which-languages-are-supported-in-dubbing)のいずれかである必要があり、地域修飾タグはサポート対象の方言のいずれかである必要があります。これは最初の言語ターゲットであるため、追加料金ではなくプロジェクトの最低料金に充当されます。IDは`language_ids`で返されます。
transcript file オプション
エンタープライズ限定。ソースの文字起こしの代わりに使用する任意のJSON文字起こしです。`{"segments": [...]}`ドキュメント形式で、最大20,000セグメント、4MiBまでです。セグメントフィールドとその制約については、[独自の文字起こしを使用する](https://elevenlabs.io/docs/eleven-api/guides/how-to/dubbing/bring-your-own-transcript)を参照してください。文字起こしを指定する場合は、必ず`source_language`が必要です。いずれかのセグメントに`translation`がある場合は`target_language`が必要であり、すべてのセグメントにtranslationが必要です。これらの翻訳は`target_language`で作成されるターゲットの初期値となり、機械翻訳はスキップされます。
レスポンス
status enum
プロジェクトのライフサイクルステータス。ソースを取得する前はqueued、文字起こし中はpreparing、文字起こし完了後に言語ターゲットを開始できる状態はready、失敗時はfailedです。プロジェクトがprocessingとして報告されることはありません。この値は言語ターゲット用です。
許可された値: queued preparing processing ready failed
revision integer
ソーストランスクリプトが編集されるたびに増加する単調カウンター（セグメントの追加／編集／削除）。
created_at string 形式: "date-time"
updated_at string 形式: "date-time"
reference string or null オプション
プロジェクト作成時にreferenceとして指定した任意形式の文字列。指定していない場合はnullです。
source_language string or null オプション
ソースメディアのBCP-47言語タグ（自動検出された場合はnull）。
model_id string or null オプション
このプロジェクトのすべての対象言語の吹き替えに使用する吹き替えモデル。作成時に固定され、言語ごとに選択することはできません。
media object or null オプション
ソースメディアのメタデータです。ソースの取得とデコードが完了すると設定されます（作成直後かつプロジェクトがreadyになる前）。それまではnullです。
language_ids list of strings オプション デフォルト値 []
このプロジェクト配下の対象言語の識別子。単一プロジェクトの取得時、およびtarget_languageによって対象言語が作成される作成時に設定されます。一覧レスポンスでは常に空です。代わりにプロジェクトの対象言語を一覧表示してください。
webhook_ids list of strings オプション デフォルト値 []
このプロジェクトとその言語がready、completed、またはfailedに達したときに通知されるワークスペースWebhookのID。
error object or null オプション
プロジェクトが失敗した理由。statusがfailedの場合を除きnullです。障害レポートの導入前に失敗した一部のプロジェクトでもnullになります。
warnings list of objects オプション
ソースの準備中に発生した非致命的な状態。ない場合は空です。最新の準備内容を反映します。特定の言語の吹き替え中に発生した状態は、代わりにその言語で報告されます。
