MiniMax: Hailuo 02

Hailuo 02 создаёт видео по тексту или изображению первого кадра и поддерживает документированный процесс с первым и последним кадрами. Команды камеры, оптимизация инструкции и зависящий от режима выбор длительности и разрешения помогают сформировать нужный план.

Ailoot Ultra · Видео POST /v1/videos minimaxi-hailuo-02

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

Hailuo 02 — видеомодель MiniMax для сцен по тексту, анимации изображений и работы с первым и последним кадрами. Письменное задание описывает объект, действие и камеру, а предоставленные изображения кадров могут задавать визуальную отправную точку или конечное состояние перехода. Выбирайте режим генерации по уже имеющемуся материалу и той части кадра, которой нужно управлять.

Для видео по тексту опишите связное действие с понятным окружением и точкой наблюдения. Например, небольшая парусная лодка проходит мимо причала, а камера следует за ней с берега. Укажите, что движется, какие детали должны оставаться видимыми и как заканчивается план. Сосредоточьте задание на наблюдаемых событиях, а не списке несвязанных визуальных качеств.

Для видео по изображению подготовьте первый кадр с уже заданными объектом и композицией. Производитель принимает JPG, JPEG, PNG и WebP меньше 20 MB с короткой стороной больше 300 пикселей и соотношением сторон от 2:5 до 5:2. Используйте изображение с видимыми важными контурами и признаками, затем опишите развивающееся из него движение.

Hailuo 02 также имеет документированный режим первого и последнего кадров. Подготовьте два изображения как нужные начальное и конечное состояния одной последовательности и опишите движение сцены между ними. Первый кадр определяет кадрирование; производитель указывает, что последний кадр другого размера обрезается под него. Заранее согласуйте композицию изображений, если объект должен оставаться видимым на протяжении перехода.

Инструкция может содержать до 2 000 символов. Hailuo 02 поддерживает команды камеры в скобках, включая push, pull, truck, pan, pedestal, tilt, zoom, tracking и статичный кадр. Команды в одних скобках запрашивают одновременное движение; команды в разных местах описания — последовательное. Производитель рекомендует сочетать не более трёх движений, поэтому выбирайте действие камеры, облегчающее восприятие объекта.

Длительность и разрешение связаны с режимом. Для видео по тексту документированы шесть или десять секунд при 768P и шесть секунд при 1080P. Для видео по изображению также документировано 512P на шесть или десять секунд. Для процесса первого и последнего кадров документированы 768P на шесть или десять секунд и 1080P на шесть секунд. Выбирайте поддерживаемое сочетание для кадра, не перенося разрешения одного режима на все остальные.

Автоматическая оптимизация инструкции — документированный параметр, включённый по умолчанию в процессе производителя. Сохраняйте его настройку при сравнении версий, поскольку переписанное задание меняет получаемые моделью данные. Сохраняйте точный текст, референсные кадры и выбранные настройки вывода вместе с сгенерированным клипом, чтобы направить правку на требующее улучшения действие или кадрирование.

Проверяйте всю готовую последовательность: начальную композицию, непрерывность объекта, темп действия и последний кадр. Для перехода проверяйте оба крайних состояния и движение между ними. Сохраняйте фактическое видео для монтажа вместе с инструкцией и референсами; следующей правкой устраняйте конкретную визуальную проблему — скрытую деталь, резкое движение камеры или слишком раннее окончание.

Ailoot Ultra · Видео POST /v1/videos minimaxi-hailuo-02

minimaxi-hailuo-02

MiniMax /minimaxi-hailuo-02

Начало

Допустимые входные данные: Текст · Картинки
Результаты: Видео

Доступно в Ailoot · входные данные и методы

Ailoot Ultra · Видео POST /v1/videos

Входные данные: text, image
Результат: video

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения minimaxi-hailuo-02 Условия: Используйте точный идентификатор модели Ailoot.	По умолчанию—
Поле`prompt`	Тип`string`	ТребованиеОбязательно	Значения и ограничения Условия: Опишите сцену и движение.	По умолчанию—
Поле`duration`	Тип`integer`	ТребованиеНеобязательно	Значения и ограничения 6, 10 Условия: Передайте одно из перечисленных значений длительности; значение по умолчанию не заявляется.	По умолчанию—
Поле`end_image`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения Условия: Последний кадр применяется только в поддерживаемом режиме ввода изображений.	По умолчанию—
Поле`image`	Тип`string or array<string>`	ТребованиеНеобязательно	Значения и ограничения Условия: Используйте фактический публично доступный URL изображения или строку изображения в base64; максимальное количество изображений здесь не заявляется.	По умолчанию—
Поле`resolution`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения 512P, 768P, 1080P Условия: Передайте одно из перечисленных значений разрешения; значение по умолчанию не заявляется.	По умолчанию—

Параметры и жизненный цикл метода

Параметр	Контракт
Параметр`content_type`	Контрактapplication/json
Параметр`required`	Контрактmodel, prompt
Параметр`optional`	Контрактduration, end_image, image, resolution
Параметр`material_types`	Контрактtext, image
Параметр`conditions`	КонтрактИспользуйте точный идентификатор модели Ailoot., Опишите сцену и движение., Передайте одно из перечисленных значений длительности; значение по умолчанию не заявляется., Последний кадр применяется только в поддерживаемом режиме ввода изображений., Используйте фактический публично доступный URL изображения или строку изображения в base64; максимальное количество изображений здесь не заявляется., Передайте одно из перечисленных значений разрешения; значение по умолчанию не заявляется.

Псевдонимы метода: /v1/videos/generations

Жизненный цикл: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифы

Как рассчитывается итоговая плата

Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.

Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.

Быстрый режим: Не указано При выборе быстрого режима
Режим flex: Не указано При выборе режима flex
Максимальная интенсивность рассуждений: Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)

Оценочные ставки для сравнения

Цены по конфигурациям

Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.

Конфигурация	Шкала ставок	Прогноз количества	Плата
КонфигурацияБазовые тарифы на токены	Шкала ставокБазовая ставка	Прогноз количества—	Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов
КонфигурацияОриентировочная стоимость генерации	Шкала ставок—	Прогноз количестваОценка для одной генерации	Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.2 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

Примеры запросов

Ailoot Ultra · Видео

curl · создать один раз и сохранить подтверждениеПрочитать исходную задачуСохранить каждый готовый материал, принадлежащий вам

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
  "model": "minimaxi-hailuo-02",
  "prompt": "A cat is walking on grass."
}
JSON
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 result.json
# Create once; retain id, polling_url, original task identifiers and every header.

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
    raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
    if isinstance(v,dict):
        for k,x in v.items(): visit(x,path+"/"+k)
    elif isinstance(v,list):
        for i,x in enumerate(v): visit(x,path+"/"+str(i))
    elif isinstance(v,str):
        u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
        if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
            roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
    target=Path(f"asset-{i}.bin")
    subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
    raw=target.read_bytes()
    if not raw: raise SystemExit("Empty asset; retain original status and metadata")
    ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
    name=f"asset-{i}.{ext}"
    if target.name!=name: target.rename(name)
    manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS

Получить и сохранить результаты

Ailoot Ultra · Видео

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Сохраняйте все готовые результаты

Сохраните каждое готовое видео или полученный файл; загрузите содержимое по каждому фактически полученному URL материала.

Сохраните полный ответ и заголовки, исходные идентификаторы, каждый фактический результат и все поля использования и учёта. Сохраните каждый уникальный ресурс, принадлежащий Ailoot, и каждую роль, которая на него ссылается.

Если нужно проверить исходный ответ

Сохраните возвращённый публичный id задачи или операции и все заголовки. Проверяйте только исходную задачу; unknown или result_pending_check не разрешают создавать новую.

Поля ответа

Поле	Тип
Поле`id`	Типstring
Поле`polling_url`	Типstring
Поле`provider_task_id`	Типstring
Поле`task_id`	Типstring
Поле`status`	Типstring
Поле`video_url`	Типstring

Псевдонимы

Псевдонимы моделей

Ailoot Ultra minimaxi-hailuo-02

Псевдонимы путей метода

/v1/videos/generations

Связанные ID для вызова

minimaxi-hailuo-02

FAQ · MiniMax: Hailuo 02

Какие входные данные и результаты доступны?: POST /v1/videos · minimaxi-hailuo-02: text, image → video
Какие поля использует запрос?: POST /v1/videos · minimaxi-hailuo-02: model, prompt, duration, end_image, image, resolution

MiniMax: Hailuo 02