吹き替え言語ターゲットを作成

プロジェクトに吹き替え言語を追加し、吹き替えをキューに登録します。 この呼び出しで吹き替えオーディオが生成され、生成ごとに課金されます。ターゲットは`queued`として作成され、プロジェクトが`ready`になるとすぐに開始します。そのため、プロジェクトの作成後であればいつでも追加できます。プロジェクトの吹き替えモデルを継承するため、別のモデルは選択できません。 `webhook_ids`を指定して作成されたプロジェクトは、出力のダウンロードURLを含む`dubbing_language_completed`イベントを送信します。そのため、このターゲットの完了をポーリングするのではなく、イベントを購読することをおすすめします。

パスパラメータ

project_idstring必須

親吹き替えプロジェクトの識別子。

ヘッダー

xi-api-keystringオプション

リクエスト

This endpoint expects an object.
target_languagestring必須

プロジェクトの吹き替え先となるBCP-47言語タグ(例:frまたはes-MX)。プロジェクトの吹き替えモデルがサポートする言語のいずれかである必要があり、リージョン指定のタグはサポート対象の方言のいずれかである必要があります。

voice_settingsobject or nullオプション

この言語のすべての話者に適用する音声設定。デフォルトを使用する場合は省略します。

translationsmap from strings to strings or nullオプション

エンタープライズ限定。機械翻訳の代わりに使用する任意の翻訳です。各ソースセグメントのexternal_id(指定していない場合はid)から翻訳テキストへのマップで、すべてのソースセグメントを正確に1回ずつ含める必要があります。最大20,000エントリ、テキスト合計4MiBまでです。独自の文字起こしを使用するを参照してください。

レスポンス

成功レスポンス。

language_idstring

言語ターゲットの一意の識別子。

project_idstring

親吹き替えプロジェクトの識別子。

target_languagestring

このターゲットの吹き替え先となるBCP-47言語タグ。

statusenum

ライフサイクルステータス。プロジェクトの準備完了またはワーカーの待機中はqueued、吹き替え処理中はprocessing、出力が利用可能になるとcompleted、出力生成後にトランスクリプトが変更された場合はstale、失敗時はfailedです。

許可された値:
revisioninteger

このターゲットのトランスクリプトが変更されるたびに増加する単調カウンター(影響するソース編集、または翻訳の編集)。

created_atstring形式: "date-time"

言語ターゲットが作成された日時。

updated_atstring形式: "date-time"

言語ターゲットが最後に更新された日時。

model_idstring or nullオプション

この対象言語の吹き替えに使用する吹き替えモデル。プロジェクトから継承され、言語ごとに選択することはできません。

voice_settingsobject or nullオプション

この言語のすべての話者に適用する音声設定。デフォルトを適用する場合はnullです。

outputsobject or nullオプション

署名付き出力URLです。ターゲットが出力を生成するまでnullです(completedになると存在し、staleの間も保持されます。出力が最新かどうかはoutput_revisionとrevisionを比較して確認します)。

output_revisioninteger or nullオプション

現在の吹き替え出力の生成元となったrevision。最新の場合はrevisionと同じで、staleの場合はそれより小さい値になります。生成が完了するまではnullです。

errorobject or nullオプション

この言語が失敗した理由。statusがfailedの場合を除きnullです。また、障害レポートの導入前に失敗した一部の言語でもnullになります。コードがproject_failedの場合は親プロジェクトが失敗したことを意味するため、根本原因はプロジェクトを確認してください。

warningslist of objectsオプション

この言語の吹き替え中に発生した非致命的な状態。ない場合は空です。最新の生成内容を反映します。ソースの準備中に発生した状態は、代わりにプロジェクトで報告されます。

エラー

422
Unprocessable Entity Error