curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "skyreels-v4-fast",
    "prompt": "A serene forest at sunset with golden light filtering through the trees.",
    "duration": 5,
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "prompt_optimizer": true
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KPEY5H3NQ2W8D7T6VB3F9GR4"
    }
  ]
}

SkyReels V4

Генерация видео SkyReels V4

Два уровня моделей: Fast (оптимизация по скорости) и Std (оптимизация по качеству)
Три режима с автоматическим выбором по полям запроса: Text-to-Video (T2V), Image-to-Video (I2V), мультимодальная ссылка (Omni)
Разрешение 480p / 720p / 1080p, длительность 3–15 секунд
Расширенные возможности: первый/последний/ключевой кадр, опорные изображения, опорные видео, коллаж-сетка, продление видео, аудиосинхронизация
Асинхронный режим обработки, возвращает ID задачи для последующего запроса

POST

videos

generations

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "skyreels-v4-fast",
    "prompt": "A serene forest at sunset with golden light filtering through the trees.",
    "duration": 5,
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "prompt_optimizer": true
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KPEY5H3NQ2W8D7T6VB3F9GR4"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "skyreels-v4-fast",
    "prompt": "A serene forest at sunset with golden light filtering through the trees.",
    "duration": 5,
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "prompt_optimizer": true
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KPEY5H3NQ2W8D7T6VB3F9GR4"
    }
  ]
}

Авторизация

Authorization

string

обязательно

Все эндпоинты API требуют аутентификации по Bearer TokenПолучение API Key:Перейдите на страницу управления API Key, чтобы получить ваш API KeyДобавьте в заголовок запроса:

Authorization: Bearer YOUR_API_KEY

Режимы генерации

SkyReels V4 автоматически выбирает корректный режим на основе полей запроса — поле mode не требуется:

Режим	Триггер	Возможности
T2V (Text-to-Video)	Только `prompt` + общие поля	Генерация полностью по тексту
I2V (Image-to-Video)	Любое из `first_frame_image` / `end_frame_image` / `mid_frame_images`	Управление первым/последним/ключевыми кадрами
Omni (мультимодальная ссылка)	Любое из `ref_images` / `ref_videos`	Опора на субъект, коллаж-сетка, опорное движение, продление видео, аудиосинхронизация

Строгое взаимоисключение: поля I2V (first_frame_image / end_frame_image / mid_frame_images) и поля Omni (ref_images / ref_videos) не могут использоваться вместе, иначе будет возвращён код 422.

Механизм @tag: при использовании mid_frame_images / ref_images / ref_videos каждый элемент должен содержать tag, начинающийся с @ (например, @image1, @Actor-1, @video1), и этот tag обязан появляться в prompt.Думайте о prompt как о «сценарии», а о tag — как об «указателе на персонаж/ресурс» для конкретных изображений/видео. Например, prompt вида "@Actor-1 walks into the scene of @video1" указывает системе встроить опорный субъект, связанный с @Actor-1, и опорное движение, связанное с @video1, в процесс генерации.

Параметры запроса

Общие поля

model

string

обязательно

Доступны два уровня моделей:

Модель	Позиционирование	Сценарии использования
`skyreels-v4-fast`	Приоритет скорости	Быстрые превью, пакетная генерация, повседневный контент
`skyreels-v4-std`	Приоритет качества (на 25~30% дороже, чем Fast)	Ключевые кадры, высокая детализация, финальная поставка

Поле model обязательно — значения по умолчанию нет.

Цена тесно связана с разрешением и использованием ref_videos: 1080p существенно дороже, чем 480p / 720p; варианты с ref_videos (входное видео) стоят примерно в 1,5–2 раза больше по сравнению с вариантами без него. Одновременный вывод аудио и видео пока не поддерживается.

prompt

string

обязательно

Текстовый промпт, максимум 1280 токеновПодробно описывайте сцены, субъектов, действия и стили для лучших результатов.При использовании ref_images / ref_videos / mid_frame_images в prompt обязательно должен присутствовать соответствующий @tag (например, @Actor-1, @video1, @image1).Пример: "@Actor-1 walks through a neon-lit street at night."

duration

integer

по умолчанию:"5"

Длительность выходного видео (секунды)

Диапазон: [3, 15]
По умолчанию: 5

При передаче ref_videos.type=reference параметр duration перекрывается длительностью опорного видео (максимум 10 секунд).

resolution

string

по умолчанию:"1080p"

Разрешение видеоВарианты:

480p
720p
1080p (по умолчанию)

aspect_ratio

string

по умолчанию:"16:9"

Соотношение сторонВарианты:

16:9 (по умолчанию)
4:3
1:1
9:16
3:4

aspect_ratio игнорируется в режиме I2V (соотношение сторон вывода определяется входным изображением); также игнорируется, когда Omni сочетается с ref_videos.

prompt_optimizer

boolean

по умолчанию:"true"

Включить ли автоматическую оптимизацию промптаПри включении система автоматически оптимизирует ваш промпт для лучших результатов генерации.

Поля, специфичные для I2V

first_frame_image

string

URL изображения для первого кадра (jpg / jpeg / png / gif / bmp)При передаче изображение используется как начальный кадр видео.

end_frame_image

string

URL изображения для последнего кадра (jpg / jpeg / png / gif / bmp)При передаче изображение используется как конечный кадр видео. Можно комбинировать с first_frame_image для управления первым и последним кадрами.

mid_frame_images

object[]

Список промежуточных ключевых кадров, до 6. Каждый элемент имеет следующую структуру:

Показать Элемент mid_frame_images

tag

string

обязательно

Должен начинаться с @ и присутствовать в prompt, например @image1

image_url

string

обязательно

URL изображения (jpg / jpeg / png / gif / bmp)

time_stamp

integer

по умолчанию:"-1"

Временная метка появления (секунды). По умолчанию -1 (не указана); если указано — должно выполняться 0 < time_stamp < duration.

Поля, специфичные для Omni

ref_images

object[]

Список опорных изображений (все элементы должны иметь одинаковый type). Каждый элемент имеет следующую структуру:

Показать Элемент ref_images

tag

string

обязательно

Должен начинаться с @ и присутствовать в prompt, например @Actor-1

type

string

обязательно

Тип ссылки:

image — обычное опорное изображение (длина списка 1–3; длина каждого image_urls 1–5)
grid — коллаж-сетка, то есть одно изображение, составленное из нескольких плиток (например, 2×2, 3×3); длина списка должна = 1, image_urls должно содержать 1 изображение

image_urls

string[]

обязательно

Массив URL изображений

audio_url

string

URL голосового аудио (поддерживается только при type=image, длительность аудио ≤ 15 секунд)

ref_videos

object[]

Список опорных видео, до 1. Каждый элемент имеет следующую структуру:

Показать Элемент ref_videos

tag

string

обязательно

Должен начинаться с @ и присутствовать в prompt, например @video1

type

string

обязательно

Тип ссылки:

reference — опорное движение / субъект, перекрывает duration (следует длительности опорного видео, максимум 10 секунд), по умолчанию переносит аудио из входного видео; можно комбинировать с ref_images.type=image
extend — продление видео, тарификация по запрошенному duration; нельзя комбинировать с ref_images

video_url

string

обязательно

URL видео (MP4 / MOV, длительность ≤ 15 секунд)

Поддерживаемые сценарии

Следующие сценарии поддерживаются обоими моделями skyreels-v4-fast и skyreels-v4-std:

Сценарий	Режим	Обязательные поля	Типичный сценарий использования
Text-to-Video	T2V	`prompt`	Полностью по тексту, быстрые концептуальные кадры
Image-to-Video — первый кадр	I2V	`first_frame_image`	Из статичного изображения в видео с заданным начальным кадром
Image-to-Video — последний кадр	I2V	`end_frame_image`	Задание заключительного кадра
Image-to-Video — ключевые кадры	I2V	`mid_frame_images` (1–6)	Первый + последний + промежуточные ключевые кадры для точного ритма
Omni — один/несколько субъектов	Omni	`ref_images` (`type=image`)	Сохранение персонажа, кадрирование с несколькими субъектами
Omni — коллаж-сетка	Omni	`ref_images` (`type=grid`, 1 изображение)	Пошаговые видео процессов (туториалы, рецепты, демо)
Omni — опорное движение	Omni	`ref_videos` (`type=reference`)	Воспроизведение движения, субъекта или стиля опорного видео
Omni — продление видео	Omni	`ref_videos` (`type=extend`)	Продолжение существующего видео новым контентом
Omni — аудиосинхронизация	Omni	`ref_images` (`type=image`) + `audio_url`	Цифровое лицо рассказчика, синхронизация губ по аудио

Ограничения параметров

Нарушение любого из следующих условий приведёт к отклонению запроса с ответом 422, тарификация не производится:

Параметр	Ограничение
`prompt`	Не более 1280 токенов
`duration`	`[3, 15]` секунд; перекрывается длительностью опорного видео (максимум 10с) при `ref_videos.type=reference`
`resolution`	Только `480p` / `720p` / `1080p`
`aspect_ratio`	`16:9` / `4:3` / `1:1` / `9:16` / `3:4`; игнорируется в I2V; игнорируется когда Omni использует `ref_videos`
`mid_frame_images`	До 6; `time_stamp` должен быть `-1` или находиться в `(0, duration)`
`ref_images` в целом	Все элементы должны иметь одинаковый `type`; нельзя сочетать с полями I2V
`ref_images.type=grid`	Длина списка должна = 1; `image_urls` должно содержать 1 изображение
`ref_images.type=image`	Длина списка 1–3; длина каждого `image_urls` 1–5
`ref_images.audio_url`	Поддерживается только при `type=image`, аудио ≤ 15 секунд
`ref_videos`	До 1; `video_url` MP4 / MOV, ≤ 15 секунд
`ref_videos.type=reference`	Перекрывает запрошенный `duration` (максимум 10с), может сочетаться с `ref_images.type=image`, по умолчанию переносит аудио из входного видео
`ref_videos.type=extend`	Тарификация по запрошенному `duration`; нельзя сочетать с `ref_images`
Поле `tag`	Должен начинаться с `@` и присутствовать в `prompt`
Взаимоисключение I2V / Omni	Поля I2V и поля Omni не могут использоваться вместе

Ответ

code

integer

Код статуса ответа, 200 при успехе

data

array

Массив данных ответа

Показать Элементы массива

status

string

Статус задачи, submitted при первичной отправке

task_id

string

Уникальный идентификатор задачи для запроса её статуса и результатов

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

Сценарий 1: Текст в видео (минимальный)

{
  "model": "skyreels-v4-fast",
  "prompt": "A serene forest at sunset with golden light filtering through the trees."
}

Сценарий 2: Текст в видео (полный набор параметров)

{
  "model": "skyreels-v4-std",
  "prompt": "A serene forest at sunset.",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "prompt_optimizer": true
}

Сценарий 3: Изображение в видео — первый кадр

{
  "model": "skyreels-v4-fast",
  "prompt": "Slowly pull the camera back to reveal the entire scene.",
  "first_frame_image": "https://example.com/start.png",
  "duration": 5
}

Сценарий 4: Изображение в видео — первый/последний кадр + промежуточные ключевые кадры

{
  "model": "skyreels-v4-std",
  "prompt": "The King summons a flying dragon. @image1 The dragon lowers. The King mounts and flies away.",
  "duration": 8,
  "resolution": "1080p",
  "first_frame_image": "https://example.com/k2v_0.png",
  "end_frame_image":   "https://example.com/k2v_2.png",
  "mid_frame_images": [
    { "tag": "@image1", "image_url": "https://example.com/k2v_1.png", "time_stamp": 3 }
  ]
}

Сценарий 5: Omni — опорный субъект (один)

{
  "model": "skyreels-v4-fast",
  "prompt": "@Actor-1 walks through a neon-lit street at night.",
  "ref_images": [
    { "tag": "@Actor-1", "type": "image", "image_urls": ["https://example.com/actor.jpg"] }
  ]
}

Сценарий 6: Omni — несколько субъектов + опорное движение из видео

{
  "model": "skyreels-v4-fast",
  "prompt": "The man from @image_1 imitates the move on the left in @video_1. The woman from @image_2 imitates the right side.",
  "duration": 5,
  "ref_images": [
    { "tag": "@image_1", "type": "image", "image_urls": ["https://example.com/a.png"] },
    { "tag": "@image_2", "type": "image", "image_urls": ["https://example.com/b.png"] }
  ],
  "ref_videos": [
    { "tag": "@video_1", "type": "reference", "video_url": "https://example.com/motion.mp4" }
  ]
}

В этом случае используется ref_videos.type=reference, поэтому запрошенный duration будет перекрыт фактической длительностью опорного видео (максимум 10 секунд). Хотя здесь передано "duration": 5, итоговая длительность видео будет следовать опорному видео.

Сценарий 7: Omni — коллаж-сетка

{
  "model": "skyreels-v4-fast",
  "prompt": "Create a video showing how to make tomato and egg noodles based on @image1.",
  "ref_images": [
    { "tag": "@image1", "type": "grid", "image_urls": ["https://example.com/recipe_grid.png"] }
  ]
}

Сценарий 8: Omni — продление видео (extend)

{
  "model": "skyreels-v4-fast",
  "prompt": "Video extended @video1, someone walks over and sits on the sofa.",
  "duration": 8,
  "ref_videos": [
    { "tag": "@video1", "type": "extend", "video_url": "https://example.com/source.mp4" }
  ]
}

Сценарий 9: Omni — аудиосинхронизация (управление голосом)

{
  "model": "skyreels-v4-std",
  "prompt": "@Actor-1 speaks with a calm tone.",
  "ref_images": [
    {
      "tag": "@Actor-1",
      "type": "image",
      "image_urls": ["https://example.com/actor.jpg"],
      "audio_url":  "https://example.com/voice.mp3"
    }
  ]
}

Запрос результатов задачиГенерация видео — асинхронная задача, которая при отправке возвращает task_id. Используйте эндпоинт Получение статуса задачи для запроса прогресса и результатов генерации.

Генерация видео MiniMax-Hailuo-2.3 Генерация видео HappyHorse 1.0

Documentation Index

​Авторизация

​Режимы генерации

​Параметры запроса

​Общие поля

​Поля, специфичные для I2V

​Поля, специфичные для Omni

​Поддерживаемые сценарии

​Ограничения параметров

​Ответ

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

​Сценарий 1: Текст в видео (минимальный)

​Сценарий 2: Текст в видео (полный набор параметров)

​Сценарий 3: Изображение в видео — первый кадр

​Сценарий 4: Изображение в видео — первый/последний кадр + промежуточные ключевые кадры

​Сценарий 5: Omni — опорный субъект (один)

​Сценарий 6: Omni — несколько субъектов + опорное движение из видео

​Сценарий 7: Omni — коллаж-сетка

​Сценарий 8: Omni — продление видео (extend)

​Сценарий 9: Omni — аудиосинхронизация (управление голосом)

Авторизация

Режимы генерации

Параметры запроса

Общие поля

Поля, специфичные для I2V

Поля, специфичные для Omni

Поддерживаемые сценарии

Ограничения параметров

Ответ

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

Сценарий 1: Текст в видео (минимальный)

Сценарий 2: Текст в видео (полный набор параметров)

Сценарий 3: Изображение в видео — первый кадр

Сценарий 4: Изображение в видео — первый/последний кадр + промежуточные ключевые кадры

Сценарий 5: Omni — опорный субъект (один)

Сценарий 6: Omni — несколько субъектов + опорное движение из видео

Сценарий 7: Omni — коллаж-сетка

Сценарий 8: Omni — продление видео (extend)

Сценарий 9: Omni — аудиосинхронизация (управление голосом)