再利用可能なリップシンクAPIを使用する理由
再利用可能なリップシンクAPIは、同じビジュアルリファレンスを使用してリップシンク動画を頻繁に生成する開発者向けに設計されたリップシンクAPIの最適化バージョンです。
何が違うのか?
| 機能 | リップシンクAPI | 再利用可能なリップシンクAPI |
|---|
| リファレンスアップロード | 各リクエストに必要 | 一度アップロード、複数回再利用 |
| トレーニングステップ | 必要 | 不要 |
| 生成のための入力 | リファレンス + 音声 | 音声のみ(リファレンス再利用) |
| 生成速度 | 標準 | はるかに速い(再トレーニング不要) |
| リクエストごとのコスト | 基本5ポイント + 1分ごとに5ポイント | 1分ごとに5ポイント |
仕組み
前のタスクIDを使用してモデルを作成する
リップシンクAPIの精密モードから前のタスクIDを使用して再利用可能なリップシンクモデルを作成します。
音声資産を公開アクセス可能なURLにホストする
サーバーが取得できるように音声ファイルをアップロードします。
適切なパラメータを使ってAPIリクエストを送信する
ホストした資産を参照し、希望するモード(標準または精密)を指定します。
待機またはステータスを照会する
ウェブフックコールバックを使用するか、処理が完了するまでジョブIDを使用してAPIをポーリングします。
動画出力をダウンロードする
提供されたURLから完成したおしゃべり写真またはリップシンク動画を取得します。
使用制限:
- 最大10件の同時ジョブを持つことができます(キューにあるリクエストを含む)。
- 推定キュー時間:1〜120分、システム負荷に応じて。
- 処理時間:約10分。
動画または写真に複数の顔が含まれている場合、リップシンクされるのは最も大きく検出された顔のみです。
モデルの有効期限ポリシー
モデル作成APIを通じて作成されたモデルには、アクティビティに基づく自動的な有効期限機構があります。
ルール
- デフォルトの有効期限
各再利用可能なリップシンクモデルは、作成日または最後の使用日から3か月間アクティブです。
- 自動延長
再利用可能なリップシンクモデルが使用されるたびに(例:再利用可能なリップシンクAPIリクエストで呼び出された場合)、その有効期限はその時点からさらに3か月延長されます。
- 有効期限
再利用可能なリップシンクモデルが3か月間使用されない場合、自動的に期限切れとなり、永久に削除される可能性があります。
- 再活性化
期限切れの再利用可能なリップシンクモデルは再活性化できません。同じ構成を使用し続けるには、リップシンクジョブを再提出し、APIを通じて再利用可能なリップシンクモデルを再作成する必要があります。
APIエラーコード
| コード | 説明 |
|---|
| 5 | 無効なリクエストパラメータ。 |
| 7 | リクエストに対する権限がありません。 |
| 104 | クレジットが不足しています。 |
| 814 | アカウントはメンバーでなく、APIを呼び出すことが許可されていません。 |
| 1000 | サーバー内部エラー。 |
| 1301 | コールバックチャレンジに失敗しました。 |
| 1302 | APIキーが取り消されました。 |
| 1304 | APIキーは同時リクエストの最大数に達しました。 |
| 1502 | オーディオドライバが無効であるか、ダウンロードできません。 |
| 1503 | アカウントはAPIを呼び出すための認可を受けていません。 |
| 1504 | 標準モードまたは以前のバージョンのタスクについては、タスクの作成がサポートされていません。 |
| 1305 | ビジネスプランのみが許可されています。 |
| 1506 | モデルが期限切れです。 |
ジョブエラーコード
| コード | 説明 |
|---|
| 999 | ファイルのダウンロードに失敗しました。 |
| 20611 | 動画トリガーフロー制限。 |