{ "aboutHtml": "

Единый результат со звуком по мультимодальному заданию

MiniMax H3 — омнимодальная видеосистема MiniMax. Она совместно интерпретирует текст, изображения, видео и аудио, затем генерирует видео со встроенным стереозвуком. Разработчик предлагает её для коротких творческих работ: визуальных материалов о товарах, рекламы, анимированных постеров и концепций кинотитров, где связи между референсными материалами важны не меньше описания сцены.

Документированная система создаёт видео длительностью 4–15 секунд с частотой 24 кадра/с и стереозвуком 32 кГц. H3-Base генерирует в 768p; полный процесс 2K повторно создаёт результат с исходным мультимодальным контекстом. Это больше, чем обычное изменение размера: на втором этапе модель вновь использует исходный контекст для восстановления мелких деталей. У H3 Max и H3-Context-IR отдельные роли и ограничения.

Создание по тексту и опорным кадрам

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

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

Генерация и редактирование по референсам

Референсный режим принимает текст вместе с изображениями, видео- и аудиоклипами. Укажите вклад каждого источника: внешность персонажа, локацию, движение камеры, временную структуру исходного клипа или голос. Видео, используемое только для движения камеры, отличается от видео, которое нужно действительно отредактировать или продолжить. Явно задайте эту связь.

Руководство разработчика по референсам разделяет определения объектов, краткое изложение задачи, анализ сохраняемых элементов, подробное описание плана, общую звуковую среду и фоновую музыку только для зрителя. Оно отличает сохранение видимого содержания от переноса атрибутов или общего стилевого ориентира. Для аудио копирование сигнала отличается от использования тембра, ритма или манеры произнесения. Сохраняйте эти роли неизменными во всём задании.

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

Речь, звук и тайминг планов

H3 совместно моделирует диалог, физические звуки, атмосферу и музыку. Карточка модели документирует стабильную поддержку диалогов на арабском, китайском, английском, французском, немецком, итальянском, японском, корейском, португальском, русском и испанском; поддержка остальных языков описана как неодинаковая. Задайте точные произносимые слова и язык, сохраняя идентичность говорящего между планами.

В руководствах разработчика по промптам описательные разделы пишутся на английском, а диалог и видимый текст сохраняются на исходном языке. Для речи используется <d>[Language] ...</d>, при этом личность говорящего и описание голоса находятся вне блока. Различайте речь персонажа в сцене и закадровое озвучивание, указывайте, продолжается ли реплика через монтажную склейку или обрывается в конце. Видимый текст тоже сохраняйте точно. Соразмеряйте объём речи с выбранной длительностью и совместно проверяйте написанные слова и слышимую реплику.

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

Подготовка входных данных и численные ограничения

Текущая схема генерации требует непустой текст в каждом режиме, до 7 000 символов на текстовый элемент. Изображения могут быть JPG, JPEG, PNG, WebP, HEIC или HEIF, до 30 МБ каждое, с каждой стороной от 256 до 5 760 пикселей и соотношением от 0.4 до 2.5. Кадровый ввод допускает одно начальное и одно конечное изображение; референсный режим — до девяти изображений.

Референсное видео может включать до трёх клипов MP4 или MOV, каждый длительностью 2–15 секунд, суммарно не более 15 секунд. Размер клипа — до 50 МБ; видеокодек H.264 или H.265, аудио AAC или MP3, стороны от 256 до 5 760 пикселей, соотношение от 0.4 до 2.5 и частота от 23.976 до 60 кадров/с. Референсное аудио поддерживает до трёх WAV или MP3, до 15 МБ каждый, каждый по 2–15 секунд, суммарно не более 15 секунд. Карточка модели ограничивает смешанный набор референсов 12 файлами. Документированный предел тела запроса — 64 МБ, отдельно от ограничений каждого файла.

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

Форма результата и полная система

Интерфейс H3 разработчика предлагает 768P и 2K. Для генерации только по тексту нужно конкретное соотношение: 21:9, 16:9, 4:3, 1:1, 3:4 или 9:16. Создание по первому/последнему кадру берёт соотношение из исходного изображения; по референсам — использует адаптивное или явное соотношение. Длительность результата задаётся целым числом секунд в диапазоне 4–15.

Карточка модели различает H3-Context-IR, интерпретирующий и обогащающий задание, H3-Base, создающий видео и звук, и H3-Regenerate-2K, формирующий результат повышенного разрешения. Выпущенные базовые контрольные точки отдельно предназначены для задач по кадрам и по омниреференсам. Компоненты контекста и повторной генерации отделены от этих базовых весов, поэтому одно название открытой контрольной точки не подтверждает поведение всей системы.

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

", "aboutText": "Единый результат со звуком по мультимодальному заданию\n\nMiniMax H3 — омнимодальная видеосистема MiniMax. Она совместно интерпретирует текст, изображения, видео и аудио, затем генерирует видео со встроенным стереозвуком. Разработчик предлагает её для коротких творческих работ: визуальных материалов о товарах, рекламы, анимированных постеров и концепций кинотитров, где связи между референсными материалами важны не меньше описания сцены.\n\nДокументированная система создаёт видео длительностью 4–15 секунд с частотой 24 кадра/с и стереозвуком 32 кГц. H3-Base генерирует в 768p; полный процесс 2K повторно создаёт результат с исходным мультимодальным контекстом. Это больше, чем обычное изменение размера: на втором этапе модель вновь использует исходный контекст для восстановления мелких деталей. У H3 Max и H3-Context-IR отдельные роли и ограничения.\n\nСоздание по тексту и опорным кадрам\n\nТекстовый ввод описывает всю последовательность изображения и звука во времени. Первое изображение закрепляет начало, последнее — конец, а два изображения могут задать оба состояния. Для плана по первому кадру начните с композиции и внешности, видимых на изображении, затем опишите развивающееся действие. Для перехода от первого к последнему кадру опишите наблюдаемое движение между состояниями вместо двух несвязанных описаний изображений.\n\nПрактическое задание для товара может задавать закрытую упаковку в начальном кадре, открывающую её руку, мягкое движение камеры и нужное конечное состояние. Сохраните форму предмета, положение этикетки и освещение в предоставленных кадрах. Создание по кадрам и по референсам — отдельные режимы ввода; интерфейс разработчика не смешивает роли первого/последнего кадра с ролями референсных медиа в одном запросе.\n\nГенерация и редактирование по референсам\n\nРеференсный режим принимает текст вместе с изображениями, видео- и аудиоклипами. Укажите вклад каждого источника: внешность персонажа, локацию, движение камеры, временную структуру исходного клипа или голос. Видео, используемое только для движения камеры, отличается от видео, которое нужно действительно отредактировать или продолжить. Явно задайте эту связь.\n\nРуководство разработчика по референсам разделяет определения объектов, краткое изложение задачи, анализ сохраняемых элементов, подробное описание плана, общую звуковую среду и фоновую музыку только для зрителя. Оно отличает сохранение видимого содержания от переноса атрибутов или общего стилевого ориентира. Для аудио копирование сигнала отличается от использования тембра, ритма или манеры произнесения. Сохраняйте эти роли неизменными во всём задании.\n\nДля сцены по референсам предоставьте изображение персонажа, короткий пример движения камеры и голосовой аудиореференс, затем опишите, где каждый влияет на целевой план. Укажите детали одежды, окружения или предметов, которые должны оставаться узнаваемыми. Сравните готовый клип с этими требованиями, включая непрерывность движения и соответствие видимого говорящего слышимому голосу.\n\nРечь, звук и тайминг планов\n\nH3 совместно моделирует диалог, физические звуки, атмосферу и музыку. Карточка модели документирует стабильную поддержку диалогов на арабском, китайском, английском, французском, немецком, итальянском, японском, корейском, португальском, русском и испанском; поддержка остальных языков описана как неодинаковая. Задайте точные произносимые слова и язык, сохраняя идентичность говорящего между планами.\n\nВ руководствах разработчика по промптам описательные разделы пишутся на английском, а диалог и видимый текст сохраняются на исходном языке. Для речи используется `[Language] ...`, при этом личность говорящего и описание голоса находятся вне блока. Различайте речь персонажа в сцене и закадровое озвучивание, указывайте, продолжается ли реплика через монтажную склейку или обрывается в конце. Видимый текст тоже сохраняйте точно. Соразмеряйте объём речи с выбранной длительностью и совместно проверяйте написанные слова и слышимую реплику.\n\nОписывайте движение камеры как действие, включая размах и скорость, когда они важны. Нумеруйте планы в порядке воспроизведения и располагайте моменты склеек в пределах длительности видео. Отделяйте звуки сцены, например шаги или закрывающуюся дверь, от фоновой музыки, слышимой только аудитории. Так короткий план съёмки проще интерпретировать и сопоставлять с результатом.\n\nПодготовка входных данных и численные ограничения\n\nТекущая схема генерации требует непустой текст в каждом режиме, до 7 000 символов на текстовый элемент. Изображения могут быть JPG, JPEG, PNG, WebP, HEIC или HEIF, до 30 МБ каждое, с каждой стороной от 256 до 5 760 пикселей и соотношением от 0.4 до 2.5. Кадровый ввод допускает одно начальное и одно конечное изображение; референсный режим — до девяти изображений.\n\nРеференсное видео может включать до трёх клипов MP4 или MOV, каждый длительностью 2–15 секунд, суммарно не более 15 секунд. Размер клипа — до 50 МБ; видеокодек H.264 или H.265, аудио AAC или MP3, стороны от 256 до 5 760 пикселей, соотношение от 0.4 до 2.5 и частота от 23.976 до 60 кадров/с. Референсное аудио поддерживает до трёх WAV или MP3, до 15 МБ каждый, каждый по 2–15 секунд, суммарно не более 15 секунд. Карточка модели ограничивает смешанный набор референсов 12 файлами. Документированный предел тела запроса — 64 МБ, отдельно от ограничений каждого файла.\n\nВыбирайте только полезные для задания референсы и явно описывайте вклад каждого. Ясное изображение объекта полезнее нескольких противоречащих видов без объяснения. Сохраняйте порядок референсов, обрезайте лишнее, не удаляя необходимый контекст сцены, и проверяйте, что короткие исходные клипы содержат запрашиваемое действие или голосовую особенность.\n\nФорма результата и полная система\n\nИнтерфейс H3 разработчика предлагает 768P и 2K. Для генерации только по тексту нужно конкретное соотношение: 21:9, 16:9, 4:3, 1:1, 3:4 или 9:16. Создание по первому/последнему кадру берёт соотношение из исходного изображения; по референсам — использует адаптивное или явное соотношение. Длительность результата задаётся целым числом секунд в диапазоне 4–15.\n\nКарточка модели различает H3-Context-IR, интерпретирующий и обогащающий задание, H3-Base, создающий видео и звук, и H3-Regenerate-2K, формирующий результат повышенного разрешения. Выпущенные базовые контрольные точки отдельно предназначены для задач по кадрам и по омниреференсам. Компоненты контекста и повторной генерации отделены от этих базовых весов, поэтому одно название открытой контрольной точки не подтверждает поведение всей системы.\n\nПроцесс генерации разработчика асинхронный. Интерфейс проверки задач получает задачи за предыдущие семь дней. Сохраняйте идентификатор до возвращения самого видеорезультата, затем сохраните клип, а не только временный адрес скачивания. Проверяйте визуальную идентичность, мелкий текст, взаимодействия объектов, речь и синхронизацию звука в целевом размере просмотра. Разработчик относит мультимодальное понимание и мелкие визуальные детали к направлениям дальнейшего улучшения; подробное задание и сравнение с источником остаются основой полезного результата.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "36a5732562c00db1ff52f6844518c5bdd5dba9d8a6be7482bc9a6232256caf27", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ru", "methods": [ { "html": "
MM

MiniMax: H3

MiniMax /minimax/hailuo-3

Начало

MiniMax H3 создаёт короткое видео со встроенным стереозвуком по тексту, изображениям кадров или мультимодальным референсам. Поддерживает создание по первому/последнему кадру, редактирование по референсам и связи движения или голоса; длительность результата — 4–15 секунд, а для 2K предусмотрен отдельный процесс повторной генерации.

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

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

Единый результат со звуком по мультимодальному заданию

MiniMax H3 — омнимодальная видеосистема MiniMax. Она совместно интерпретирует текст, изображения, видео и аудио, затем генерирует видео со встроенным стереозвуком. Разработчик предлагает её для коротких творческих работ: визуальных материалов о товарах, рекламы, анимированных постеров и концепций кинотитров, где связи между референсными материалами важны не меньше описания сцены.

Документированная система создаёт видео длительностью 4–15 секунд с частотой 24 кадра/с и стереозвуком 32 кГц. H3-Base генерирует в 768p; полный процесс 2K повторно создаёт результат с исходным мультимодальным контекстом. Это больше, чем обычное изменение размера: на втором этапе модель вновь использует исходный контекст для восстановления мелких деталей. У H3 Max и H3-Context-IR отдельные роли и ограничения.

Создание по тексту и опорным кадрам

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

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

Генерация и редактирование по референсам

Референсный режим принимает текст вместе с изображениями, видео- и аудиоклипами. Укажите вклад каждого источника: внешность персонажа, локацию, движение камеры, временную структуру исходного клипа или голос. Видео, используемое только для движения камеры, отличается от видео, которое нужно действительно отредактировать или продолжить. Явно задайте эту связь.

Руководство разработчика по референсам разделяет определения объектов, краткое изложение задачи, анализ сохраняемых элементов, подробное описание плана, общую звуковую среду и фоновую музыку только для зрителя. Оно отличает сохранение видимого содержания от переноса атрибутов или общего стилевого ориентира. Для аудио копирование сигнала отличается от использования тембра, ритма или манеры произнесения. Сохраняйте эти роли неизменными во всём задании.

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

Речь, звук и тайминг планов

H3 совместно моделирует диалог, физические звуки, атмосферу и музыку. Карточка модели документирует стабильную поддержку диалогов на арабском, китайском, английском, французском, немецком, итальянском, японском, корейском, португальском, русском и испанском; поддержка остальных языков описана как неодинаковая. Задайте точные произносимые слова и язык, сохраняя идентичность говорящего между планами.

В руководствах разработчика по промптам описательные разделы пишутся на английском, а диалог и видимый текст сохраняются на исходном языке. Для речи используется <d>[Language] ...</d>, при этом личность говорящего и описание голоса находятся вне блока. Различайте речь персонажа в сцене и закадровое озвучивание, указывайте, продолжается ли реплика через монтажную склейку или обрывается в конце. Видимый текст тоже сохраняйте точно. Соразмеряйте объём речи с выбранной длительностью и совместно проверяйте написанные слова и слышимую реплику.

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

Подготовка входных данных и численные ограничения

Текущая схема генерации требует непустой текст в каждом режиме, до 7 000 символов на текстовый элемент. Изображения могут быть JPG, JPEG, PNG, WebP, HEIC или HEIF, до 30 МБ каждое, с каждой стороной от 256 до 5 760 пикселей и соотношением от 0.4 до 2.5. Кадровый ввод допускает одно начальное и одно конечное изображение; референсный режим — до девяти изображений.

Референсное видео может включать до трёх клипов MP4 или MOV, каждый длительностью 2–15 секунд, суммарно не более 15 секунд. Размер клипа — до 50 МБ; видеокодек H.264 или H.265, аудио AAC или MP3, стороны от 256 до 5 760 пикселей, соотношение от 0.4 до 2.5 и частота от 23.976 до 60 кадров/с. Референсное аудио поддерживает до трёх WAV или MP3, до 15 МБ каждый, каждый по 2–15 секунд, суммарно не более 15 секунд. Карточка модели ограничивает смешанный набор референсов 12 файлами. Документированный предел тела запроса — 64 МБ, отдельно от ограничений каждого файла.

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

Форма результата и полная система

Интерфейс H3 разработчика предлагает 768P и 2K. Для генерации только по тексту нужно конкретное соотношение: 21:9, 16:9, 4:3, 1:1, 3:4 или 9:16. Создание по первому/последнему кадру берёт соотношение из исходного изображения; по референсам — использует адаптивное или явное соотношение. Длительность результата задаётся целым числом секунд в диапазоне 4–15.

Карточка модели различает H3-Context-IR, интерпретирующий и обогащающий задание, H3-Base, создающий видео и звук, и H3-Regenerate-2K, формирующий результат повышенного разрешения. Выпущенные базовые контрольные точки отдельно предназначены для задач по кадрам и по омниреференсам. Компоненты контекста и повторной генерации отделены от этих базовых весов, поэтому одно название открытой контрольной точки не подтверждает поведение всей системы.

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

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

Ailoot Ultra · Видео POST /v1/videos
Входные данные
text, image, audio, video
Результат
video
Выходной формат
Исходные байты MP4; без нормализации и перекодирования
ПолеТипТребованиеЗначения и ограниченияПо умолчанию
ПолеmodelТипstringТребованиеОбязательноЗначения и ограничения
minimax/hailuo-3
По умолчанию—
ПолеpromptТипstringТребованиеОбязательноЗначения и ограниченияПо умолчанию—
ПолеdurationТипintegerТребованиеОбязательноЗначения и ограничения
5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Минимум: 1
Максимум: 600
По умолчанию—
ПолеresolutionТипstringТребованиеНеобязательноЗначения и ограничения
2K
По умолчанию—
Полеaspect_ratioТипstringТребованиеНеобязательноЗначения и ограничения
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
По умолчанию—
Полеgenerate_audioТипbooleanТребованиеНеобязательноЗначения и ограничения
false, true
По умолчанию—
Полеframe_imagesТипarrayТребованиеНеобязательноЗначения и ограничения
Минимум элементов: 1
Максимум элементов: 2
Входное содержимое: Массив объектов кадров. Каждый объект содержит type=image_url, image_url с url и frame_type. Используйте HTTPS URL изображения и укажите first_frame или last_frame в frame_type. Каждая роль кадра встречается не более одного раза.
Точные ключи: type, image_url, frame_type
Условия: Эти ключи описывают каждый объект кадра; image_url содержит только url. Не передавайте frame_images для запроса только с текстом.
По умолчанию—
Полеinput_referencesТипarrayТребованиеНеобязательноЗначения и ограниченияПо умолчанию—
Полеcallback_urlТипstringТребованиеНеобязательноЗначения и ограничения
Шаблон: ^https://
По умолчанию—
Полеsession_idТипstringТребованиеНеобязательноЗначения и ограниченияПо умолчанию—
ПолеtraceТипobjectТребованиеНеобязательноЗначения и ограниченияПо умолчанию—
ПолеuserТипstringТребованиеНеобязательноЗначения и ограниченияПо умолчанию—
Сочетания входных материалов

Из текста в видео · Текстовый запрос. · Обязательно: model, prompt, duration

Передайте prompt как текст, а duration — как целое число секунд. Выберите поддерживаемое разрешение и, при необходимости, соотношение сторон.

model: Тип: string · minimax/hailuo-3

prompt: Тип: string · Максимум байтов UTF-8: 10 000 · Нужен хотя бы один непробельный символ: Да

Из изображения в видео · Текстовый запрос и изображение первого кадра. · Обязательно: model, prompt, duration, frame_images

frame_images — массив. Каждый объект кадра содержит type, image_url и frame_type; image_url содержит url. Укажите image_url в type. Используйте first_frame с необязательным last_frame. Каждая роль кадра встречается не более одного раза. Для каждого кадра укажите публичный HTTPS URL изображения. В одном запросе используйте изображения кадров либо референсные изображения; не совмещайте их. Выберите поддерживаемое разрешение и, при необходимости, соотношение сторон.

Точные ключи: type, image_url, frame_type

model: Тип: string · minimax/hailuo-3

prompt: Тип: string · Максимум байтов UTF-8: 10 000 · Нужен хотя бы один непробельный символ: Да

Reference to video · Текстовый запрос и поддерживаемые референсы: изображения, видео, аудио. · Обязательно: model, prompt, duration, input_references

input_references — массив объектов. Укажите image_url, video_url или audio_url в type и используйте соответствующее поле с url. Используйте публичные HTTPS-ссылки. Не передавайте frame_images, чтобы выбрать режим референсов. В оценку входит показанная плата за изображение только для референсов сверх первых пяти. Итоговое начисление определяется фактически тарифицированной конфигурацией. Не совмещайте референсные изображения с изображениями кадров. Выберите поддерживаемое разрешение и, при необходимости, соотношение сторон.

model: Тип: string · minimax/hailuo-3

prompt: Тип: string · Максимум байтов UTF-8: 10 000 · Нужен хотя бы один непробельный символ: Да

Параметры и жизненный цикл метода
ПараметрКонтракт
Параметрcontent_typeКонтрактapplication/json
ПараметрrequiredКонтрактmodel, prompt, duration
Параметрmaterial_typesКонтрактtext, image, audio, video
Параметрadditional_propertiesКонтрактfalse
Параметрoptional_controlsКонтрактresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user

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

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

Тарифы

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

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

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

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

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

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

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

КонфигурацияШкала ставокПрогноз количестваРасчётная единицаУсловия расчётаПлата
КонфигурацияБазовые тарифы на токеныШкала ставокБазовая ставкаПрогноз количества—Расчётная единица—Условия расчёта—Плата
Вход · Входные токены · Оценка только для сравнения — / 1K токенов
Выход · Выходные токены · Оценка только для сравнения — / 1K токенов
Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов
Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов
Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов
КонфигурацияЦена видеоШкала ставок—Прогноз количества—Расчётная единицаза секунду видеоУсловия расчётаВ этом ключе цены дополнительное условие не объявлено.Плата
Выход · Цена видео · Оценка только для сравнения $0.26 за секунду видео
Конфигурацияреференсное изображениеШкала ставок—Прогноз количества—Расчётная единицаза изображение-референсУсловия расчёта—Плата
Вход · референсное изображение · Оценка только для сравнения $0.08 за изображение-референс
КонфигурацияОриентировочная стоимость генерацииШкала ставок—Прогноз количестваОценка для одной генерацииРасчётная единица—Условия расчёта—Плата
Выход · Оценочная стоимость генерации · Оценка только для сравнения $1.3 оценка до генерации

Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

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

Сведения о справочном тарифе

Справочные шкалы модели не меняют выбор метода, расчёт стоимости или списания. Действующая плата определяется ставками выбранного метода Ailoot.

Ссылки на цены конфигураций видео

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

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

КонфигурацияУсловия расчётаПлата
КонфигурацияЦена видеоУсловия расчётаВ этом ключе цены дополнительное условие не объявлено.Плата
Выход · Цена видео $0.26 за секунду видео

Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации.

КонфигурацияРеференсные изображения сверх первых пятиУсловия расчётаВ этом ключе цены дополнительное условие не объявлено.Плата
Вход · Референсные изображения после первых пяти $0.08 за изображение

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

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

Ailoot Ultra · Видео

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"minimax/hailuo-3","prompt":"A serene mountain landscape at sunset","resolution":"2K"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n

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

Ailoot Ultra · Видео

подписанные ссылки на содержимое, принадлежащее Ailoot

Проверить статус задачи
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
Чтение другого содержимого
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    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')\n    target=Path('owned-'+label+'.bin')\n    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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
Сохраняйте все готовые результаты

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

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

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

503 result_pending_check + исходный id + X-Should-Retry:false; никогда не отправляйте исходный запрос повторно

Поля ответа
ПолеТипЗначение
ПолеindexТипintegerЗначениеПозиция этого видео в списке результатов, начиная с нуля.
Полеcontent_urlТипstringЗначениеПодписанный HTTPS URL для скачивания этого готового видео.
Полеsha256Типstring | nullЗначениеХэш SHA-256 исходных байтов видео; null, если недоступен.
Полеsize_bytesТипinteger | nullЗначениеРазмер исходного видеофайла в байтах; null, если недоступен.
Полеduration_msТипinteger | nullЗначениеИзмеренная длительность видео в миллисекундах; null, если недоступна.
ПолеwidthТипinteger | nullЗначениеШирина видео в пикселях; null, если недоступна.
ПолеheightТипinteger | nullЗначениеВысота видео в пикселях; null, если недоступна.
Полеvideo_codecТипstring | nullЗначениеИдентификатор видеокодека; null, если не записан.
Полеhas_audioТипboolean | nullЗначениеЕсть ли у видео аудиодорожка; null, если не измерено.
Полеaudio_codecТипstring | nullЗначениеИдентификатор аудиокодека; null, если идентификатор не записан.
Ошибки и дальнейшие шаги
ОтветУсловиеСледующий шаг
Ответ404 · not_found_errorУсловиеДоступ к видео недоступен либо этот ID видео не найден.Следующий шагПроверьте доступ к видео. Для существующего видео используйте исходный публичный ID и тот же ключ API.
Ответ401 · authentication_errorУсловиеКлюч API не соответствует авторизованному аккаунту.Следующий шагПеред отправкой проверьте ключ API и доступ к аккаунту.
Ответ400 · invalid_request_errorУсловиеНе удалось прочитать запрос либо индекс скачивания недопустим.Следующий шагИсправьте тело запроса. Для скачивания выберите индекс результата, возвращённый исходной задачей.
Ответ422 · price_unavailableУсловиеНевозможно определить цену выбранной конфигурации видео.Следующий шагВыберите поддерживаемую конфигурацию видео и заполните обязательные параметры перед отправкой исправленного запроса.
Ответ422 · invalid_request_errorУсловиеНедопустимы входное видео или исходная задача продолжения.Следующий шагИспользуйте корректные входные HTTPS-ссылки. Для продолжения используйте исходный публичный ID вашего готового видео и тот же ключ API.
Ответ402 · billing_errorУсловиеДоступный баланс или лимиты не позволяют зарезервировать средства.Следующий шагПеред отправкой нового запроса проверьте доступный баланс и лимиты.
Ответ503 · server_errorУсловиеПроверка видео, хранилище или доступ к сервису временно недоступны.Следующий шагДождитесь доступности сервиса. Если у вас уже есть ID видео, проверяйте ту исходную задачу вместо создания новой генерации.
Ответ503 · result_pending_checkУсловиеНужно проверить результат исходного видео и начисление.Следующий шагСохраните возвращённый ID видео и проверьте эту задачу. Не отправляйте заменяющий запрос на генерацию, пока идёт проверка.
Ответ503 · owned_result_unavailableУсловиеСкачивание существующего видео временно недоступно.Следующий шагПроверьте ту же видеозадачу позже и скачайте её существующий результат. Новая генерация создаёт отдельную операцию.
Ответ409 · video_not_readyУсловиеСодержимое видео не опубликовано.Следующий шагПроверьте исходный статус задачи. Скачайте результат после completed; при failed следуйте уведомлению о проверке начисления.

Псевдонимы

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

Ailoot Ultra minimax/hailuo-3

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

Используйте пути методов, указанные выше.

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

minimax/hailuo-3

", "method_identity": { "effective_request_model_id": "minimax/hailuo-3", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "minimax/hailuo-3", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|minimax%2Fhailuo-3", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Сохраняйте каждый фактический результат, принадлежащий Ailoot, и возвращённые измеренные метаданные.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Доступ к видео недоступен либо этот ID видео не найден.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Проверьте доступ к видео. Для существующего видео используйте исходный публичный ID и тот же ключ API.", "type": "not_found_error" }, { "condition": "Ключ API не соответствует авторизованному аккаунту.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Перед отправкой проверьте ключ API и доступ к аккаунту.", "type": "authentication_error" }, { "condition": "Не удалось прочитать запрос либо индекс скачивания недопустим.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Исправьте тело запроса. Для скачивания выберите индекс результата, возвращённый исходной задачей.", "type": "invalid_request_error" }, { "condition": "Невозможно определить цену выбранной конфигурации видео.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Выберите поддерживаемую конфигурацию видео и заполните обязательные параметры перед отправкой исправленного запроса.", "type": "price_unavailable" }, { "condition": "Недопустимы входное видео или исходная задача продолжения.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Используйте корректные входные HTTPS-ссылки. Для продолжения используйте исходный публичный ID вашего готового видео и тот же ключ API.", "type": "invalid_request_error" }, { "condition": "Доступный баланс или лимиты не позволяют зарезервировать средства.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Перед отправкой нового запроса проверьте доступный баланс и лимиты.", "type": "billing_error" }, { "condition": "Проверка видео, хранилище или доступ к сервису временно недоступны.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Дождитесь доступности сервиса. Если у вас уже есть ID видео, проверяйте ту исходную задачу вместо создания новой генерации.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Нужно проверить результат исходного видео и начисление.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Сохраните возвращённый ID видео и проверьте эту задачу. Не отправляйте заменяющий запрос на генерацию, пока идёт проверка.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Скачивание существующего видео временно недоступно.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Проверьте ту же видеозадачу позже и скачайте её существующий результат. Новая генерация создаёт отдельную операцию.", "type": "server_error" }, { "condition": "Содержимое видео не опубликовано.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Проверьте исходный статус задачи. Скачайте результат после completed; при failed следуйте уведомлению о проверке начисления.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + исходный id + X-Should-Retry:false; никогда не отправляйте исходный запрос повторно" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Передайте prompt как текст, а duration — как целое число секунд. Выберите поддерживаемое разрешение и, при необходимости, соотношение сторон.", "required": [ "model", "prompt", "duration" ], "required_material": "Текстовый запрос." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images — массив. Каждый объект кадра содержит type, image_url и frame_type; image_url содержит url. Укажите image_url в type. Используйте first_frame с необязательным last_frame. Каждая роль кадра встречается не более одного раза. Для каждого кадра укажите публичный HTTPS URL изображения. В одном запросе используйте изображения кадров либо референсные изображения; не совмещайте их. Выберите поддерживаемое разрешение и, при необходимости, соотношение сторон.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Текстовый запрос и изображение первого кадра." }, { "mode": "Reference to video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references — массив объектов. Укажите image_url, video_url или audio_url в type и используйте соответствующее поле с url. Используйте публичные HTTPS-ссылки. Не передавайте frame_images, чтобы выбрать режим референсов. В оценку входит показанная плата за изображение только для референсов сверх первых пяти. Итоговое начисление определяется фактически тарифицированной конфигурацией. Не совмещайте референсные изображения с изображениями кадров. Выберите поддерживаемое разрешение и, при необходимости, соотношение сторон.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Текстовый запрос и поддерживаемые референсы: изображения, видео, аудио." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Позиция этого видео в списке результатов, начиная с нуля.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Подписанный HTTPS URL для скачивания этого готового видео.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Хэш SHA-256 исходных байтов видео; null, если недоступен.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Размер исходного видеофайла в байтах; null, если недоступен.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Измеренная длительность видео в миллисекундах; null, если недоступна.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Ширина видео в пикселях; null, если недоступна.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Высота видео в пикселях; null, если недоступна.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Идентификатор видеокодека; null, если не записан.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Есть ли у видео аудиодорожка; null, если не измерено.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Идентификатор аудиокодека; null, если идентификатор не записан.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "подписанные ссылки на содержимое, принадлежащее Ailoot", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "2K" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "2K" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Эти ключи описывают каждый объект кадра; image_url содержит только url. Не передавайте frame_images для запроса только с текстом.", "content": "Массив объектов кадров. Каждый объект содержит type=image_url, image_url с url и frame_type. Используйте HTTPS URL изображения и укажите first_frame или last_frame в frame_type. Каждая роль кадра встречается не более одного раза.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "minimax/hailuo-3" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "2K" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Frame images plus image references are rejected because mixed additive input count is unproved; pure frame or pure reference mode remains separately priced." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio", "video" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "basis": "Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Ориентировочная стоимость генерации", "units": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"minimax/hailuo-3\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"2K\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio", "video" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "minimax/hailuo-3", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" }, { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "minimax/hailuo-3", "nativeProvenance": { "input_facts_canonical_sha256": "9175c246af3a2e2d94ce6ded6c4a9e8f848a95039a919e61bcc6d66ca9a5fba6", "input_html_sha256": "befc8edc58625e5e8ff0d7a8a1ffe6e6a31d0279d32c1f1b46844b0941ae8aa7", "private_audit_sha256": "931ee8702c5435560d3d9530b3ba4e334ffec1f12fc0810a95d93b22c693c7b3", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/ru/minimax-hailuo-3/", "description": "MiniMax H3 создаёт короткое видео со встроенным стереозвуком по тексту, изображениям кадров или мультимодальным референсам. Поддерживает создание по первому/последнему кадру, редактирование по референсам и связи движения или голоса; длительность результата — 4–15 секунд, а для 2K предусмотрен отдельный процесс повторной генерации.", "locale": "ru", "md_url": "https://ailoot.ai/models/ru/minimax-hailuo-3/index.md", "title": "MiniMax: H3 — Ailoot", "url": "https://ailoot.ai/models/ru/minimax-hailuo-3/" }, "rawModel": { "about": "Единый результат со звуком по мультимодальному заданию\n\nMiniMax H3 — омнимодальная видеосистема MiniMax. Она совместно интерпретирует текст, изображения, видео и аудио, затем генерирует видео со встроенным стереозвуком. Разработчик предлагает её для коротких творческих работ: визуальных материалов о товарах, рекламы, анимированных постеров и концепций кинотитров, где связи между референсными материалами важны не меньше описания сцены.\n\nДокументированная система создаёт видео длительностью 4–15 секунд с частотой 24 кадра/с и стереозвуком 32 кГц. H3-Base генерирует в 768p; полный процесс 2K повторно создаёт результат с исходным мультимодальным контекстом. Это больше, чем обычное изменение размера: на втором этапе модель вновь использует исходный контекст для восстановления мелких деталей. У H3 Max и H3-Context-IR отдельные роли и ограничения.\n\nСоздание по тексту и опорным кадрам\n\nТекстовый ввод описывает всю последовательность изображения и звука во времени. Первое изображение закрепляет начало, последнее — конец, а два изображения могут задать оба состояния. Для плана по первому кадру начните с композиции и внешности, видимых на изображении, затем опишите развивающееся действие. Для перехода от первого к последнему кадру опишите наблюдаемое движение между состояниями вместо двух несвязанных описаний изображений.\n\nПрактическое задание для товара может задавать закрытую упаковку в начальном кадре, открывающую её руку, мягкое движение камеры и нужное конечное состояние. Сохраните форму предмета, положение этикетки и освещение в предоставленных кадрах. Создание по кадрам и по референсам — отдельные режимы ввода; интерфейс разработчика не смешивает роли первого/последнего кадра с ролями референсных медиа в одном запросе.\n\nГенерация и редактирование по референсам\n\nРеференсный режим принимает текст вместе с изображениями, видео- и аудиоклипами. Укажите вклад каждого источника: внешность персонажа, локацию, движение камеры, временную структуру исходного клипа или голос. Видео, используемое только для движения камеры, отличается от видео, которое нужно действительно отредактировать или продолжить. Явно задайте эту связь.\n\nРуководство разработчика по референсам разделяет определения объектов, краткое изложение задачи, анализ сохраняемых элементов, подробное описание плана, общую звуковую среду и фоновую музыку только для зрителя. Оно отличает сохранение видимого содержания от переноса атрибутов или общего стилевого ориентира. Для аудио копирование сигнала отличается от использования тембра, ритма или манеры произнесения. Сохраняйте эти роли неизменными во всём задании.\n\nДля сцены по референсам предоставьте изображение персонажа, короткий пример движения камеры и голосовой аудиореференс, затем опишите, где каждый влияет на целевой план. Укажите детали одежды, окружения или предметов, которые должны оставаться узнаваемыми. Сравните готовый клип с этими требованиями, включая непрерывность движения и соответствие видимого говорящего слышимому голосу.\n\nРечь, звук и тайминг планов\n\nH3 совместно моделирует диалог, физические звуки, атмосферу и музыку. Карточка модели документирует стабильную поддержку диалогов на арабском, китайском, английском, французском, немецком, итальянском, японском, корейском, португальском, русском и испанском; поддержка остальных языков описана как неодинаковая. Задайте точные произносимые слова и язык, сохраняя идентичность говорящего между планами.\n\nВ руководствах разработчика по промптам описательные разделы пишутся на английском, а диалог и видимый текст сохраняются на исходном языке. Для речи используется `[Language] ...`, при этом личность говорящего и описание голоса находятся вне блока. Различайте речь персонажа в сцене и закадровое озвучивание, указывайте, продолжается ли реплика через монтажную склейку или обрывается в конце. Видимый текст тоже сохраняйте точно. Соразмеряйте объём речи с выбранной длительностью и совместно проверяйте написанные слова и слышимую реплику.\n\nОписывайте движение камеры как действие, включая размах и скорость, когда они важны. Нумеруйте планы в порядке воспроизведения и располагайте моменты склеек в пределах длительности видео. Отделяйте звуки сцены, например шаги или закрывающуюся дверь, от фоновой музыки, слышимой только аудитории. Так короткий план съёмки проще интерпретировать и сопоставлять с результатом.\n\nПодготовка входных данных и численные ограничения\n\nТекущая схема генерации требует непустой текст в каждом режиме, до 7 000 символов на текстовый элемент. Изображения могут быть JPG, JPEG, PNG, WebP, HEIC или HEIF, до 30 МБ каждое, с каждой стороной от 256 до 5 760 пикселей и соотношением от 0.4 до 2.5. Кадровый ввод допускает одно начальное и одно конечное изображение; референсный режим — до девяти изображений.\n\nРеференсное видео может включать до трёх клипов MP4 или MOV, каждый длительностью 2–15 секунд, суммарно не более 15 секунд. Размер клипа — до 50 МБ; видеокодек H.264 или H.265, аудио AAC или MP3, стороны от 256 до 5 760 пикселей, соотношение от 0.4 до 2.5 и частота от 23.976 до 60 кадров/с. Референсное аудио поддерживает до трёх WAV или MP3, до 15 МБ каждый, каждый по 2–15 секунд, суммарно не более 15 секунд. Карточка модели ограничивает смешанный набор референсов 12 файлами. Документированный предел тела запроса — 64 МБ, отдельно от ограничений каждого файла.\n\nВыбирайте только полезные для задания референсы и явно описывайте вклад каждого. Ясное изображение объекта полезнее нескольких противоречащих видов без объяснения. Сохраняйте порядок референсов, обрезайте лишнее, не удаляя необходимый контекст сцены, и проверяйте, что короткие исходные клипы содержат запрашиваемое действие или голосовую особенность.\n\nФорма результата и полная система\n\nИнтерфейс H3 разработчика предлагает 768P и 2K. Для генерации только по тексту нужно конкретное соотношение: 21:9, 16:9, 4:3, 1:1, 3:4 или 9:16. Создание по первому/последнему кадру берёт соотношение из исходного изображения; по референсам — использует адаптивное или явное соотношение. Длительность результата задаётся целым числом секунд в диапазоне 4–15.\n\nКарточка модели различает H3-Context-IR, интерпретирующий и обогащающий задание, H3-Base, создающий видео и звук, и H3-Regenerate-2K, формирующий результат повышенного разрешения. Выпущенные базовые контрольные точки отдельно предназначены для задач по кадрам и по омниреференсам. Компоненты контекста и повторной генерации отделены от этих базовых весов, поэтому одно название открытой контрольной точки не подтверждает поведение всей системы.\n\nПроцесс генерации разработчика асинхронный. Интерфейс проверки задач получает задачи за предыдущие семь дней. Сохраняйте идентификатор до возвращения самого видеорезультата, затем сохраните клип, а не только временный адрес скачивания. Проверяйте визуальную идентичность, мелкий текст, взаимодействия объектов, речь и синхронизацию звука в целевом размере просмотра. Разработчик относит мультимодальное понимание и мелкие визуальные детали к направлениям дальнейшего улучшения; подробное задание и сравнение с источником остаются основой полезного результата.", "alias_of": null, "aliases": [], "author": "MiniMax", "available": null, "canonical_model": "minimax/hailuo-3", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image", "video", "audio" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Полная информация о ценах конфигурации — в подробностях." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "ffcc346d33bca9e66b22f181", "label": "Ссылки на цены конфигураций видео", "profiles": [ { "basis": "Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации.", "dimensions": { "conditions": "В этом ключе цены дополнительное условие не объявлено." }, "label": "Цена видео", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Первые пять референсных изображений бесплатны; указанная ставка за изображение применяется сверх первых пяти. Опубликованная справочная цена относится к показанной конфигурации. Итоговые начисления определяются фактически тарифицированной конфигурацией.", "dimensions": { "conditions": "В этом ключе цены дополнительное условие не объявлено." }, "label": "Референсные изображения сверх первых пяти", "units": [ { "amount": "0.08", "amount_unit": "usd_per_image", "billing_input": false, "key": "input_image", "label": "Reference images after the first five", "public_unit_label": "per image", "quantity": 1, "rate_role": "typed_video_image_reference", "side": "in", "unit": "image" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "minimax/hailuo-3", "input": [ "text", "image", "audio", "video" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Сохраняйте каждый фактический результат, принадлежащий Ailoot, и возвращённые измеренные метаданные.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Доступ к видео недоступен либо этот ID видео не найден.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Проверьте доступ к видео. Для существующего видео используйте исходный публичный ID и тот же ключ API.", "type": "not_found_error" }, { "condition": "Ключ API не соответствует авторизованному аккаунту.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Перед отправкой проверьте ключ API и доступ к аккаунту.", "type": "authentication_error" }, { "condition": "Не удалось прочитать запрос либо индекс скачивания недопустим.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Исправьте тело запроса. Для скачивания выберите индекс результата, возвращённый исходной задачей.", "type": "invalid_request_error" }, { "condition": "Невозможно определить цену выбранной конфигурации видео.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Выберите поддерживаемую конфигурацию видео и заполните обязательные параметры перед отправкой исправленного запроса.", "type": "price_unavailable" }, { "condition": "Недопустимы входное видео или исходная задача продолжения.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Используйте корректные входные HTTPS-ссылки. Для продолжения используйте исходный публичный ID вашего готового видео и тот же ключ API.", "type": "invalid_request_error" }, { "condition": "Доступный баланс или лимиты не позволяют зарезервировать средства.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Перед отправкой нового запроса проверьте доступный баланс и лимиты.", "type": "billing_error" }, { "condition": "Проверка видео, хранилище или доступ к сервису временно недоступны.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Дождитесь доступности сервиса. Если у вас уже есть ID видео, проверяйте ту исходную задачу вместо создания новой генерации.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Нужно проверить результат исходного видео и начисление.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Сохраните возвращённый ID видео и проверьте эту задачу. Не отправляйте заменяющий запрос на генерацию, пока идёт проверка.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Скачивание существующего видео временно недоступно.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Проверьте ту же видеозадачу позже и скачайте её существующий результат. Новая генерация создаёт отдельную операцию.", "type": "server_error" }, { "condition": "Содержимое видео не опубликовано.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Проверьте исходный статус задачи. Скачайте результат после completed; при failed следуйте уведомлению о проверке начисления.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + исходный id + X-Should-Retry:false; никогда не отправляйте исходный запрос повторно" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Передайте prompt как текст, а duration — как целое число секунд. Выберите поддерживаемое разрешение и, при необходимости, соотношение сторон.", "required": [ "model", "prompt", "duration" ], "required_material": "Текстовый запрос." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images — массив. Каждый объект кадра содержит type, image_url и frame_type; image_url содержит url. Укажите image_url в type. Используйте first_frame с необязательным last_frame. Каждая роль кадра встречается не более одного раза. Для каждого кадра укажите публичный HTTPS URL изображения. В одном запросе используйте изображения кадров либо референсные изображения; не совмещайте их. Выберите поддерживаемое разрешение и, при необходимости, соотношение сторон.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Текстовый запрос и изображение первого кадра." }, { "mode": "Reference to video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references — массив объектов. Укажите image_url, video_url или audio_url в type и используйте соответствующее поле с url. Используйте публичные HTTPS-ссылки. Не передавайте frame_images, чтобы выбрать режим референсов. В оценку входит показанная плата за изображение только для референсов сверх первых пяти. Итоговое начисление определяется фактически тарифицированной конфигурацией. Не совмещайте референсные изображения с изображениями кадров. Выберите поддерживаемое разрешение и, при необходимости, соотношение сторон.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Текстовый запрос и поддерживаемые референсы: изображения, видео, аудио." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Позиция этого видео в списке результатов, начиная с нуля.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Подписанный HTTPS URL для скачивания этого готового видео.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Хэш SHA-256 исходных байтов видео; null, если недоступен.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Размер исходного видеофайла в байтах; null, если недоступен.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Измеренная длительность видео в миллисекундах; null, если недоступна.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Ширина видео в пикселях; null, если недоступна.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Высота видео в пикселях; null, если недоступна.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Идентификатор видеокодека; null, если не записан.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Есть ли у видео аудиодорожка; null, если не измерено.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Идентификатор аудиокодека; null, если идентификатор не записан.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "подписанные ссылки на содержимое, принадлежащее Ailoot", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "2K" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "2K" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Эти ключи описывают каждый объект кадра; image_url содержит только url. Не передавайте frame_images для запроса только с текстом.", "content": "Массив объектов кадров. Каждый объект содержит type=image_url, image_url с url и frame_type. Используйте HTTPS URL изображения и укажите first_frame или last_frame в frame_type. Каждая роль кадра встречается не более одного раза.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "minimax/hailuo-3" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "2K" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Frame images plus image references are rejected because mixed additive input count is unproved; pure frame or pure reference mode remains separately priced." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio", "video" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "basis": "Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Ориентировочная стоимость генерации", "units": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"minimax/hailuo-3\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"2K\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio", "video" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "minimax/hailuo-3", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" }, { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "minimax/hailuo-3", "request_model_id": "minimax/hailuo-3", "route_label": "Ultra" } ], "name": "MiniMax: H3", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 1.3, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 1.3, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.16", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "768P" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "2K" }, "label": "Ultra", "units": [ { "amount": "0.26", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "2K" }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.16", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "768P" }, "key": "input_video", "label": "input video", "profile_index": 2, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "2K" }, "label": "Ultra", "units": [ { "amount": "0.26", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "2K" }, "key": "input_video", "label": "input video", "profile_index": 3, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "first_free_reference_images": 5, "only_additional_images_charged": true, "reference_audio_free": true }, "label": "Ultra", "units": [ { "amount": "0.08", "amount_unit": "usd_per_input_image", "conditions": { "adds_to_output": true, "first_free_reference_images": 5, "only_additional_images_charged": true, "reference_audio_free": true }, "key": "input_image", "label": "input image", "profile_index": 4, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_image" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.26", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second", "billing_original_currency": "USD", "billing_original_rate": "0.26", "key": "duration_seconds", "label": "output second", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.08", "amount_unit": "usd_per_exact_physical_unit", "basis": "reference image", "billing_original_currency": "USD", "billing_original_rate": "0.08", "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "quantity": 1, "side": "in", "unit": "reference_image" } ] } ], "public_id": "minimax/hailuo-3", "short": "MiniMax H3 создаёт короткое видео со встроенным стереозвуком по тексту, изображениям кадров или мультимодальным референсам. Поддерживает создание по первому/последнему кадру, редактирование по референсам и связи движения или голоса; длительность результата — 4–15 секунд, а для 2K предусмотрен отдельный процесс повторной генерации." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "MiniMax H3 создаёт короткое видео со встроенным стереозвуком по тексту, изображениям кадров или мультимодальным референсам. Поддерживает создание по первому/последнему кадру, редактирование по референсам и связи движения или голоса; длительность результата — 4–15 секунд, а для 2K предусмотрен отдельный процесс повторной генерации.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "41c5c17fe1e19c250bde4b62dec0122086973bfd11d7cb586df65166d13dbddd", "renderer_sha256": "aa692ffec412026bdeaf316df24a58e6c5083045e5246f6033f898d132afa5ff" }, "sourceRevision": "4cf4caf9786b099a2c2ec7a890d91b6c03205df963ea3e2d7768d83f18104e5a" }