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