Hailuo 2.3 Fast
MiniMax Hailuo 2.3 Fast анимирует изображение первого кадра по короткому описанию движения. Выберите этот профиль генерации видео по изображению для товарного плана, позы персонажа или кадра раскадровки.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
MiniMax Hailuo 2.3 Fast — отдельный профиль Fast для генерации видео по изображению. Начните с подготовленной композиции первого кадра и опишите движение объекта или камеры. Фотография товара, поза персонажа или кадр раскадровки дают плану конкретную визуальную отправную точку.
Подготовьте изображение и описание движения
Предоставьте квадратное изображение PNG или JPEG по HTTPS URL; каждая сторона должна быть от 300 до 4 096 пикселей. Размер скачиваемого изображения — не более 20 000 000 байт. Промпт длиной от 1 до 199 символов сосредоточьте на одном видимом действии и важном для плана движении.
Проследите создание клипа до завершения
Этот профиль настроен на один MP4-клип 768 × 768 с номинальной длительностью шесть секунд. Отправьте запрос один раз, сохраните полученный ID и отслеживайте именно этот исходный запрос до завершения. Скачайте возвращённое видео и сохраните сообщённые размеры и измеренную длительность вместе с результатом. Если исход создания неизвестен, продолжайте проверять исходный запрос вместо его повторного создания.
Ailoot Ultra · Видео POST /v1/videos MiniMax-Hailuo-2.3-Fast
MiniMax-Hailuo-2.3-FastНачало
MiniMax Hailuo 2.3 Fast анимирует изображение первого кадра по короткому описанию движения. Выберите этот профиль генерации видео по изображению для товарного плана, позы персонажа или кадра раскадровки.
- Допустимые входные данные
- Текст · Картинки
- Результаты
- Видео
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Видео POST /v1/videos
- Входные данные
text,image- Результат
video- Выходной формат
- mp4
- Число результатов
- До 1 выход
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения MiniMax-Hailuo-2.3-Fast | По умолчанию— |
Полеprompt | Типstring | ТребованиеОбязательно | Значения и ограничения Минимальная длина: 1 Максимальная длина: 199 Единица: символы Unicode | По умолчанию— |
Полеduration | Типinteger | ТребованиеОбязательно | Значения и ограничения 6 Единица: секунды | По умолчанию— |
Полеresolution | Типstring | ТребованиеОбязательно | Значения и ограничения 768P | По умолчанию— |
Полеfirst_frame_image | Типhttps_url | ТребованиеОбязательно | Значения и ограничения Максимальный размер файла, байты: 20 000 000 Типы MIME: image/png, image/jpeg Минимальный размер: 300 Максимальный размер: 4 096 Только квадрат: Да | По умолчанию— |
Сочетания входных материалов
Из изображения в видео · Обязательно: prompt, first_frame_image
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, prompt, duration, resolution, first_frame_image |
Параметрother_options | Контрактfalse |
Параметрduration | Контракт6 |
Параметрresolution | Контракт768P |
Параметрprompt_max_characters | Контракт199 |
Параметрfirst_frame_image | Контракт{"type":"https_url","format":["png","jpeg"],"dimensions":"квадрат со стороной 300..4096 пикселей","full_image_validation_before_send":true,"maximum_file_bytes":20000000} |
Параметрmaterial_types | Контрактtext, image |
Параметрadditional_properties | Контрактfalse |
Псевдонимы метода: /v1/videos/generations, /videos, /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/videos/generations/{request_id}/content
Создайте один раз и сохраните возвращённый ID.
Проверяйте исходный статус; сохраняйте каждый готовый ресурс и его длительность.
Тарифы
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
- Быстрый режим
- Не указано При выборе быстрого режима
- Режим flex
- Не указано При выборе режима flex
- Максимальная интенсивность рассуждений
- Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
Ставки Ailoot
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Номинальная длительность клипа, секунды | Разрешение | Расчётная единица | Плата |
|---|---|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Номинальная длительность клипа, секунды— | Разрешение— | Расчётная единица— | Плата Вход · Входные токены — / 1K токенов Выход · Выходные токены — / 1K токенов Вход · Чтение кэша — / 1K токенов Вход · Запись в кэш — / 1K токенов Вход · Запись в кэш, 1 час — / 1K токенов |
| КонфигурацияUltra | Шкала ставок— | Номинальная длительность клипа, секунды6 | Разрешение768P | Расчётная единицаза выходной клип номинальной длительностью 6s | Плата Выход · выходной ролик номинальной длительностью 6s $0.4 за выходной клип номинальной длительностью 6s |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Сведения о справочном тарифе
Справочные шкалы модели не меняют выбор метода, расчёт стоимости или списания. Действующая плата определяется ставками выбранного метода Ailoot.
MiniMax-Hailuo-2.3-Fast
Цены по конфигурациям
| Конфигурация | Условия расчёта | Плата |
|---|---|---|
| КонфигурацияMiniMax-Hailuo-2.3-Fast · Стандартная конфигурация | Условия расчётаКонфигурация по умолчанию | Плата Вход · Вход 0,00 $ за вызов Выход · Выход 0,40 $ за вызов |
MiniMax-Hailuo-2.3-Fast
Цены по конфигурациям
| Конфигурация | Условия расчёта | Плата |
|---|---|---|
| КонфигурацияMiniMax-Hailuo-2.3-Fast · Стандартная конфигурация | Условия расчётаКонфигурация по умолчанию | Плата Вход · Вход 0,00 $ за вызов Выход · Выход 0,80 $ за вызов |
MiniMax-Hailuo-2.3-Fast
Цены по конфигурациям
| Конфигурация | Условия расчёта | Плата |
|---|---|---|
| КонфигурацияMiniMax-Hailuo-2.3-Fast · Конфигурация по умолчанию | Условия расчётаКонфигурация по умолчанию | Плата Вход · Вход 0,00 $ за вызов Выход · Выход 0,80 $ за вызов |
Примеры запросов
Ailoot Ultra · Видео
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_IMAGE_URL:?Set the actual HTTPS first-frame image URL}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3-Fast", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')
from urllib.parse import urlsplit
u=os.environ["AILOOT_IMAGE_URL"]
z=urlsplit(u)
if z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Choose the actual HTTPS first-frame image URL")
p["first_frame_image"]=u
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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 result.json
Получить и сохранить результаты
Ailoot Ultra · Видео
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Проверить статус задачи
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Чтение другого содержимого
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())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Сохраняйте все готовые результаты
Сохраните каждое готовое видео или полученный файл; загрузите содержимое по каждому фактически полученному URL материала.
Готовый data[] содержит все подписанные URL содержимого, принадлежащие Ailoot. Получите данные по каждому возвращённому URL либо используйте конечную точку содержимого, указав в index фактический индекс результата. Неудачная исходная задача может вернуть charge_pending_check; проверяйте её, а не создавайте заново.
Если нужно проверить исходный ответ
Проверяйте существующую исходную задачу; никогда не повторяйте отправку с неизвестным исходом.
Максимум результатов: 1.
Поля ответа
| Поле | Тип | Значение |
|---|---|---|
Полеid | Типstring | Значение— |
Полеobject | Типstring | Значение— |
Полеmodel | Типstring | Значение— |
Полеstatus | Типstring | Значение— |
Полеdata[] | Типsigned content URL | Значение— |
Полеcharge_pending_check | Типboolean | Значение— |
Полеerror.code | Типstring | Значение— |
Полеerror.message | Типstring | Значение— |
Полеrequested_nominal_duration_seconds | Типinteger | Значение— |
Полеmeasured_duration_seconds | Типnumber | Значение— |
Полеwidth | Типinteger | Значение— |
Полеheight | Типinteger | Значение— |
Полеoperation_id | Типstring | ЗначениеВозвращается при status=unknown; фактический исходный публичный ID видеооперации |
Полеrequest_id | Типstring | ЗначениеНеобязательно при status=unknown; возвращается, только если у исходной задачи есть ID запроса |
Ошибки и дальнейшие шаги
| Ответ | Условие | Следующий шаг |
|---|---|---|
Ответ400 · invalid_request_error | УсловиеНе удалось прочитать исходное тело запроса до разбора профиля видео | Следующий шагСохраните возвращённый ответ и исправьте нечитаемое тело запроса. |
Ответ422 · price_unavailable | УсловиеНе удалось разобрать точный профиль видео либо для полностью разобранного профиля нет готовой точной тарифной карточки | Следующий шагСохраните ответ; используйте полный точный допущенный профиль и его опубликованную карточку. Эта ветвь выполняется до отправки поставщику. |
Ответ409 · video_not_ready | УсловиеСодержимое исходного результата пока недоступно | Следующий шагПроверяйте исходный возвращённый ID и соблюдайте Retry-After. |
Ответserver_error | УсловиеВозвращённый ответ указывает, что операция или результат требуют проверки | Следующий шагСохраните исходный возвращённый ID операции или задачи, заголовки запроса и ответ; продолжайте поддерживаемые операции чтения исходной операции. Не отправляйте запрос создания повторно. |
Ответ200 · video_result_unverified | УсловиеСостояние исходной задачи Fast неизвестно; status=unknown и charge_pending_check=true | Следующий шагСохраните фактически возвращённые id/operation_id и необязательный request_id; проверяйте только исходную задачу. Никогда не отправляйте повторно. |
Псевдонимы
Псевдонимы моделей
Ailoot Ultra MiniMax-Hailuo-2.3-Fast
Псевдонимы путей метода
/v1/videos/generations, /videos, /videos/generations
Связанные ID для вызова
FAQ · Hailuo 2.3 Fast
- Какие входные данные и результаты доступны?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:text,image→video- Какие поля использует запрос?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:model,prompt,duration,resolution,first_frame_image- Какие ограничения действуют?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:prompt.maximum_length:199