> ## Documentation Index
> Fetch the complete documentation index at: https://www.vozo.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 概要

> 再利用可能なリップシンクモデルを使用してリップシンクまたはおしゃべり写真を作成する

## 再利用可能なリップシンクAPIを使用する理由

再利用可能なリップシンクAPIは、同じビジュアルリファレンスを使用してリップシンク動画を頻繁に生成する開発者向けに設計されたリップシンクAPIの最適化バージョンです。

### 何が違うのか？

| 機能           | リップシンクAPI            | 再利用可能なリップシンクAPI   |
| :----------- | :------------------- | :---------------- |
| リファレンスアップロード | 各リクエストに必要            | 一度アップロード、複数回再利用   |
| トレーニングステップ   | 必要                   | 不要                |
| 生成のための入力     | リファレンス + 音声          | 音声のみ（リファレンス再利用）   |
| 生成速度         | 標準                   | はるかに速い（再トレーニング不要） |
| リクエストごとのコスト  | 基本5ポイント + 1分ごとに5ポイント | 1分ごとに5ポイント        |

## 仕組み

<Steps>
  <Step title="前のタスクIDを使用してモデルを作成する">
    リップシンクAPIの精密モードから前のタスクIDを使用して再利用可能なリップシンクモデルを作成します。
  </Step>

  <Step title="音声資産を公開アクセス可能なURLにホストする">
    サーバーが取得できるように音声ファイルをアップロードします。
  </Step>

  <Step title="適切なパラメータを使ってAPIリクエストを送信する">
    ホスティングされた資産を参照し、希望のモード（スタンダードまたはプレシジョン）を指定してください。
  </Step>

  <Step title="待機またはステータスを照会する">
    ウェブフックコールバックを使用するか、ジョブIDを使ってAPIをポーリングし、処理が完了するまで待ってください。
  </Step>

  <Step title="動画出力をダウンロードする">
    提供されたURLから完成したおしゃべり写真またはリップシンクされた動画を取得してください。
  </Step>
</Steps>

## 使用制限：

* 最大10件の同時ジョブを持つことができます（キューにあるリクエストを含む）。
* 推定キュー時間：1〜120分、システム負荷に応じて。
* 処理時間：約10分。

<Note>
  動画や写真に複数の顔が含まれている場合、リップシンクされるのは検出された最大の顔のみです。
</Note>

## モデルの有効期限ポリシー

モデル作成APIを通じて作成されたモデルには、アクティビティに基づく自動的な有効期限機構があります。

### ルール

1. デフォルトの有効期限 各再利用可能なリップシンクモデルは作成日または最終使用から3か月間アクティブのままです。
2. 自動延長 再利用可能なリップシンクモデルが使用されるたびに（例：再利用可能なリップシンクAPIリクエストで呼び出される）、その有効期限はその時点からさらに3か月延長されます。
3. 有効期限 再利用可能なリップシンクモデルが3か月連続で使用されない場合、自動的に失効し、永久に削除される場合があります。
4. 再活性化 失効した再利用可能なリップシンクモデルは再活性化できません。同じ構成を使用し続けるには、リップシンクジョブを再送信し、APIを通じて再利用可能なリップシンクモデルを再作成する必要があります。

## APIエラーコード

| コード  | 説明                                              |
| ---- | ----------------------------------------------- |
| 5    | 無効なリクエストパラメーター。                                 |
| 7    | リクエストする権限がありません。                                |
| 104  | クレジット不足。                                        |
| 814  | あなたのアカウントはメンバーではなく、APIを呼び出すことができません。            |
| 1000 | 内部サーバーエラー。                                      |
| 1301 | コールバックチャレンジに失敗しました。                             |
| 1302 | APIキーが取り消されました。                                 |
| 1304 | APIキーは最大同時リクエスト数に達しました。                         |
| 1502 | オーディオドライバーが無効またはダウンロードできません。                    |
| 1503 | あなたのアカウントはAPIを呼び出す権限がありません。                     |
| 1504 | タスクの作成はスタンダードモードまたは以前のバージョンからのタスクではサポートされていません。 |
| 1305 | スタジオプランのみが許可されています。                             |
| 1506 | モデルは失効しています。                                    |

## ジョブエラーコード

| コード   | 説明                  |
| ----- | ------------------- |
| 999   | ファイルのダウンロードに失敗しました。 |
| 20611 | 動画トリガーフロー制限。        |