動作方式
アセットを公開アクセス可能なURLにホストする
動画、写真、音声ファイルをアップロードし、サーバーがそれらを取得できるようにします。
適切なパラメータでAPIリクエストを送信する
ホストしたアセットを参照し、希望するモード(スタンダードまたはプレシジョン)を指定します。
待機またはステータスを照会する
Webhookコールバックを使用するか、ジョブIDを使ってAPIをポーリングして処理が完了するまで待ちます。
動画出力をダウンロードする
提供されたURLから完成したおしゃべり写真またはリップシンク動画を取得します。
使用制限:
- 同時に最大10件のジョブ(キューにあるリクエストを含む)を持つことができます。
- 単一の顔の動画または写真のみがサポートされています。
- 推定キュー時間:システム負荷に応じて1〜120分。
- スタンダードモードの処理時間:約10分。
- プレシジョンモードの処理時間:約20分。
動画または写真に複数の顔が含まれている場合、検出された中で最大の顔のみがリップシンクされます。
APIエラーコード
| コード | 説明 |
|---|
| 5 | 無効なリクエストパラメータ。 |
| 7 | リクエストの権限がありません。 |
| 104 | クレジットが不足しています。 |
| 814 | あなたのアカウントはメンバーではなく、APIを呼び出すことができません。 |
| 1000 | 内部サーバーエラー。 |
| 1301 | コールバックチャレンジに失敗しました。 |
| 1302 | APIキーが取り消されました。 |
| 1304 | APIキーが同時リクエストの最大数に達しました。 |
| 1502 | あなたのオーディオドライバーは無効であるか、ダウンロードできません。 |
| 1503 | あなたのアカウントはAPIを呼び出す権限がありません。 |
| 1305 | ビジネスプランのみが許可されています。 |
ジョブエラーコード
| コード | 説明 |
|---|
| 999 | ファイルのダウンロードに失敗しました。 |
| 20403 | 顔が不足しています。 |
| 20407 | 顔トラックの数が多すぎます。 |
| 20408 | 画像から動画への顔認識に失敗しました。 |
| 20601 | 写真に顔がありません。 |
| 20602 | 不明な画像形式です。 |
| 20611 | 動画トリガーのフロー制限。 |
| 20613 | 画像に敏感な動画入力を生成しています。 |