HeyGen: Avatar IV
Avatar IVは、声に導かれる表情やジェスチャーのタイミングで、写真をリップシンクしたトーキング動画にします。HeyGenは、台本または録音音声のワークフローと、写実的・スタイライズされたプレゼンター向けPhoto Avatarの動作制御を文書化しています。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
Avatar IVは、静止画像を表情豊かなトーキング動画に変えるHeyGenのアバターエンジンです。拡散モデルに着想を得た音声から表情への設計により、声の調子、リズム、感情が、顔の動き、首の傾き、間、微表情を導きます。目的は、リップシンクとジェスチャーを伴って発話内容を伝えるプレゼンターやキャラクターであり、映画的なプロンプトから場所や音声トラック全体を作る汎用シーン生成器とは異なります。
メーカーは、角度付きや横顔の画像、アニメ調の顔、ペットなど、写実的・スタイライズされたキャラクターへの対応を説明しています。写真ベースのキャラクターは、目、口、顔の構造が識別しやすいと効果的です。HeyGenは、明瞭で照明が良く、姿勢が自然な画像を勧め、ジェスチャーが重要な場合は手も見せるよう求めています。顔が極端に小さい、唇が隠れる、重いマスク、目立つくちばし、強く誇張した比率などは、顔の動きやリップシンクを弱める場合があります。意図した演技に合う元画像の構図を保ちます。
メーカーは二つの発話入力経路を提供します。文章の台本には選んだ音声を組み合わせ、事前録音の音声トラックは声とタイミングを直接与えます。話し方がすでに決まっているなら録音音声、発話を合成する必要があるなら台本を使います。文書化された画面では、これらは代替の入力です。動画化の前に最終文面、名前、発音を整え、返された動画とともに音声や台本を残して、話された内容を確認できるようにします。
HeyGenのAvatar IVプロファイルは、スタジオアバター、Digital Twins、Photo Avatars、直接入力する画像、プロンプト作成の被写体を対象とします。再利用できるPhoto Avatarは後の動画でも安定した被写体を提供し、直接画像のフローは入力画像から始まります。メーカーのPhoto Avatarプロファイルには、自由文の動作指示とhigh、medium、lowの表現力の選択肢があり、既定値はlowです。シリーズでは選んだ外観とエンジンを維持し、元画像や描画モデルの変更が気づかないプレゼンター変更にならないようにします。
動作の指示では、目に見える身体動作とその感情的な質を記述します。「温かい笑顔で穏やかにうなずく」なら、一つのジェスチャーと一つの表情です。短いあいさつには親しみのある手振りを使えます。メーカーは、主なジェスチャーを一つにし、必要なら表情を合わせ、連続動作でも短い節を二つ以内にするよう勧めています。Avatar IVは演技からペースを扱うため、Studioガイドは秒単位のジェスチャー予定を要求しません。具体的で簡潔な文面は、一つのプロンプトに競合する動作を多数入れるより確認しやすくなります。
メーカーの音声から動画のプロファイルは、一件のリクエストで最大30分の入力音声を描画し、アップロードするMP3・WAV素材は32 MBが上限です。長い講義や録音では、意味のまとまった発話の境界で分割し、元の順序を保ちます。完成動画の発話タイミングは、無関係なクリップ時間の見積もりではなく、選択音声に従う必要があります。
文書化された出力設定には720p、1080pと、16:9、9:16、4:5、5:4、1:1があり、元の比率に従う自動オプションもあります。coverは被写体を切り取る場合があり、containは全体を収め、周囲の背景が見える場合があります。音声から動画のフローは既定でMP4を返します。動画アバターの透明WebM出力にはマッティング対応が必要で、メーカーは新しい背景と組み合わせるのでなく、背景除去を適用します。大きな構成へ配置する前に、実際の構図とファイルを確認します。
研修の導入なら、見やすいプレゼンター画像、簡潔な説明、重要な指示で一つの控えめなジェスチャーを使えます。商品説明なら、同じアバターの外観を保ち、機能ごとに台本を変えられます。メーカーは任意の字幕ファイルと焼き付け字幕も文書化しており、発話とともに文面とタイミングを確認します。メーカーの描画は非同期なので、作成応答と完成動画は別の成果物です。完成録画と完了状態をタスク結果とともに保持します。
Avatar IVは、参照に基づく動きと別のStudioプリセット制御を持つAvatar Vとは異なります。HeyGen Videoの汎用シーン生成や、インタラクティブなライブアバター会話とも別です。描画された口の動き、見える手、表情、間、発話内容を、元素材と意図した調子に照らして確認します。画像、姿勢、照明、動作指示が結果に影響します。写真からのアニメーションは生成された演技として確認し、選んだ入力を後の修正用に保存します。
Ailoot Ultra · 動画 POST /v1/videos heygen/avatar-iv
heygen/avatar-ivはじめに
Avatar IVは、声に導かれる表情やジェスチャーのタイミングで、写真をリップシンクしたトーキング動画にします。HeyGenは、台本または録音音声のワークフローと、写実的・スタイライズされたプレゼンター向けPhoto Avatarの動作制御を文書化しています。
- 対応する入力
- テキスト · 画像 · 音声 · 動画
- 結果
- 動画
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · 動画 POST /v1/videos
- 入力の種類
text,image,audio,video- 出力の種類
video
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 heygen/avatar-iv | デフォルト— |
フィールドinput_references | 種類array | 要件必須 | 値と制限 最小項目数: 2 最大項目数: 2 | デフォルト— |
フィールドprompt | 種類string | 要件任意 | 値と制限 | デフォルト— |
メソッドのパラメータとライフサイクル
| パラメータ | 仕様 |
|---|---|
パラメータcontent_type | 仕様application/json |
パラメータrequired | 仕様model, input_references |
パラメータmaterial_types | 仕様text, image, audio, video |
パラメータmaterial_conditions | 仕様実際に完了した所有メディアアセットのコンテンツURLを、返された署名付きで使用してください。BFLでは動画ソースを一つ、アバターでは画像と音声のソースを一つずつ使用します。ソースの所有者・型・バイト列の証跡が必要です。, PNG/JPEG画像を厳密に一つと、WAV/MP3音声アセットを一つ指定してください。音声は最大32000000バイトで、長さは0秒を超え1800秒以下である必要があります。 |
ライフサイクル: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · 実際に返されたidまたはpolling_url
GET /v1/videos/{request_id}/content
料金
最終料金の計算方法
表示料金は生成前の費用の見積もりです。最終請求額は、元の生成処理に記録された費用から計算されます。実測された出力時間や予測数量が、そのまま最終的な課金数量になるわけではありません。
料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。
- 高速モード
- 未指定 高速モードが選択されている場合
- Flex モード
- 未指定 flex モードが選択されている場合
- 最大推論量
- 未指定 推論量が最大で、調整に既定値(default)を使用する場合
比較用の推定料金
設定別の価格
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 料金表 | 予測数量 | 課金単位 | 課金条件 | 料金 |
|---|---|---|---|---|---|
| 設定基本トークン料金 | 料金表基本料金 | 予測数量— | 課金単位— | 課金条件— | 料金 入力 · 入力トークン · 比較専用の見積もり — / 1K トークン 出力 · 出力トークン · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ読み取り · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ書き込み · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ書き込み、1時間 · 比較専用の見積もり — / 1K トークン |
| 設定動画料金 | 料金表— | 予測数量— | 課金単位動画1秒あたり | 課金条件この価格キーには追加条件が定義されていません。 | 料金 出力 · 動画料金 · 比較専用の見積もり $0.1 動画1秒あたり |
| 設定生成費用の見積もり | 料金表— | 予測数量生成1回分の概算 | 課金単位— | 課金条件— | 料金 出力 · 推定生成コスト · 比較専用の見積もり $0.1 生成前の見積もり この見積もりは追加料金ではなく、完了した生成処理に対する固定料金でもありません。 |
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
リクエスト例
Ailoot Ultra · 動画
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"
export AILOOT_INPUT_REFERENCES_JSON
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'heygen/avatar-iv', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
結果を受け取って保存
Ailoot Ultra · 動画
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
完了したアセットをすべて保存
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
完了した結果をすべて保存
完了した動画や返されたファイルをすべて保存し、実際に返されたすべてのアセットURLから取得してください。
レスポンスとヘッダーの全体、実際の出力すべて、最初に返された識別子、使用量フィールドすべてを保存してください。作成リクエストを再送せずに、元の操作を復旧してください。
元のレスポンスを確認する場合
X-Client-Request-ID、X-Ailoot-Task-Id、および実際に返されたid/polling_urlを保持してください。元のジョブを継続し、作成リクエストを再送信しないでください。
レスポンスのフィールド
| フィールド | 種類 |
|---|---|
フィールドid | 種類 |
フィールドstatus | 種類 |
フィールドdata[] | 種類 |
フィールドoutputs[] | 種類 |
エイリアス
モデルのエイリアス
Ailoot Ultra heygen/avatar-iv
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用ID
FAQ · HeyGen: Avatar IV
- 利用できる入力と結果は何ですか?
POST /v1/videos·heygen/avatar-iv:text,image,audio,video→video- リクエストはどの項目を使用しますか?
POST /v1/videos·heygen/avatar-iv:model,input_references,prompt