モデル

HeyGen: Avatar IV

Markdown · JSON

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

HeyGen /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
完了したアセットをすべて保存
GET · 完了した全アセットの取得
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

heygen/avatar-iv

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

詳細を見る

AilootをClaude Code、OpenCode、Hermes、自分のアプリに接続しましょう。

企業とそのプロジェクト群

企業とそのプロジェクト群:数百万の顧客、毎月数十億規模の売上。

トークンを割引価格で購入。

継続利用にサブスクリプション割引。プロモコードでトークン購入が最大50%割引。

サブスクリプション
定期的なリクエストに合う割引プランを選びましょう。
最大50%のプロモコード
購入時にコードを入力すると、実施中のキャンペーンに沿って価格を再計算します。
支出を履歴で確認
各リクエストのモデル、トークン、金額が保存されます。

サブスクリプションを選ぶ · モデルの価格を見る

販売する製品に、 APIを組み込みましょう。

SaaS、アプリ、ボットをAilootの公式サービス提供条件とライセンス契約に基づいて接続できます。再販にはリセラーライセンスを申請できます。

商用アプリ
サービスの有料機能に、文章、画像、動画、音声の生成を組み込めます。
リセラーライセンス
プロジェクトの説明とアクセスの仕組みをお送りください。利用・再販条件の書面を申請できます。
サイトで契約文書を確認
接続前にサービス提供条件、ライセンス契約、データ処理ポリシーを読めます。

リセラーライセンスを申請 · サービス提供条件とライセンス契約