HeyGen: Avatar IV
Avatar IV анимирует фото в говорящее видео с синхронизацией губ, мимикой и жестами под голос. HeyGen документирует сценарий с текстом или записанным аудио и настройки движения Photo Avatar для реалистичных или стилизованных ведущих.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
Avatar IV — движок аватаров HeyGen для превращения изображения в выразительное говорящее видео. Его вдохновлённый диффузией audio-to-expression-дизайн использует тон, ритм и эмоцию голоса для мимики, наклонов головы, пауз и микровыражений лица. Назначение — ведущий или персонаж с речью, синхронизацией губ и жестами, а не общий генератор окружения и звуковой дорожки по кинематографическому промпту.
Производитель описывает реалистичных и стилизованных персонажей, включая ракурсные и профильные изображения, лица аниме и питомцев. Фотоперсонажи лучше работают с различимыми глазами, ртом и строением лица. HeyGen рекомендует ясное освещённое изображение, естественную позу и видимые руки при важных жестах. Маленькое лицо, скрытые губы, тяжёлые маски, выраженный клюв или сильно преувеличенные пропорции могут ухудшать мимику и синхронизацию. Кадрируйте исходник под исполнение.
Есть два речевых входа. Письменный сценарий сочетается с выбранным голосом; готовая аудиодорожка напрямую задаёт голос и время. Записанное аудио выбирайте при установленной подаче, текст — при необходимости синтеза. Это альтернативы документированного интерфейса. До анимации подготовьте слова, имена и произношение; храните аудио или сценарий с видео для проверки речи.
Профиль Avatar IV охватывает студийных аватаров, Digital Twins, Photo Avatars, прямые изображения и созданных промптом субъектов. Повторно используемый Photo Avatar задаёт постоянного персонажа для следующих видео, прямое изображение начинает с картинки. Профиль Photo Avatar предлагает свободные инструкции движения и выразительность high, medium или low, по умолчанию low. В серии сохраняйте облик и движок, чтобы смена исходника или модели не стала незамеченной сменой ведущего.
Движение описывайте видимым действием тела и эмоциональной окраской. «Мягко кивает с тёплой улыбкой» задаёт жест и выражение; приветствие может использовать дружелюбный взмах. Рекомендован один основной жест, необязательно с мимикой, максимум две короткие части фразы для последовательности. Avatar IV получает темп из исполнения, поэтому Studio не требует посекундного графика жестов. Конкретный короткий текст проще проверять, чем конкурирующие действия.
Профиль audio-to-video рендерит до тридцати минут переданного аудио на запрос; загруженные MP3/WAV ограничены 32 MB. Длинный урок или запись делите по связным речевым границам с сохранением порядка. Время речи итогового видео должно следовать аудио, а не несвязанной оценке длины клипа.
Выходные настройки производителя включают 720p или 1080p и формы 16:9, 9:16, 4:5, 5:4 или 1:1, а также автоматическое следование исходным пропорциям. Cover может обрезать персонажа; contain помещает его целиком, оставляя окружение. Audio-to-video по умолчанию возвращает MP4. Прозрачный WebM видеоаватаров требует matting; для него производитель удаляет фон, а не сочетает с новым. Проверьте реальное кадрирование и файл до большой композиции.
Учебное вступление использует читаемый образ ведущего, краткое объяснение и сдержанный жест на ключевой инструкции. Продуктовое объяснение сохраняет аватара, меняя сценарий функций. Производитель также документирует необязательные файлы субтитров и вшитые в изображение субтитры; проверяйте слова и время вместе с речью. Рендер асинхронен, ответ создания и готовое видео — разные материалы. Храните готовую запись и состояние завершения с результатом задачи.
Avatar IV отличается от референсного движения Avatar V и отдельных настроек Studio, от общей генерации 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 содержимого готовых медиаресурсов, принадлежащих Ailoot, с возвращёнными подписями: один видеоисточник для BFL либо один источник изображения и один аудиоисточник для аватара. Требуется подтверждение владельца, типа и байтов в Source., Передайте ровно одно изображение 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)
Оценочные ставки для сравнения
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Прогноз количества | Расчётная единица | Условия расчёта | Плата |
|---|---|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Прогноз количества— | Расчётная единица— | Условия расчёта— | Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов |
| КонфигурацияЦена видео | Шкала ставок— | Прогноз количества— | Расчётная единицаза секунду видео | Условия расчётаВ этом ключе цены дополнительное условие не объявлено. | Плата Выход · Цена видео · Оценка только для сравнения $0.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