Skip to main content
POST

Авторизация

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

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

SkyReels V4 автоматически выбирает корректный режим на основе полей запроса — поле mode не требуется:
Строгое взаимоисключение: поля 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, в процесс генерации.

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

Общие поля

string
обязательно
Доступны два уровня моделей:
Поле model обязательно — значения по умолчанию нет.
Цена тесно связана с разрешением и использованием ref_videos: 1080p существенно дороже, чем 480p / 720p; варианты с ref_videos (входное видео) стоят примерно в 1,5–2 раза больше по сравнению с вариантами без него. Одновременный вывод аудио и видео пока не поддерживается.
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации видео.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
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."
integer
по умолчанию:"5"
Длительность выходного видео (секунды)
  • Диапазон: [3, 15]
  • По умолчанию: 5
При передаче ref_videos.type=reference параметр duration перекрывается длительностью опорного видео (максимум 10 секунд).
string
по умолчанию:"1080p"
Разрешение видеоВарианты:
  • 480p
  • 720p
  • 1080p (по умолчанию)
string
по умолчанию:"16:9"
Соотношение сторонВарианты:
  • 16:9 (по умолчанию)
  • 4:3
  • 1:1
  • 9:16
  • 3:4
aspect_ratio игнорируется в режиме I2V (соотношение сторон вывода определяется входным изображением); также игнорируется, когда Omni сочетается с ref_videos.
boolean
по умолчанию:"true"
Включить ли автоматическую оптимизацию промптаПри включении система автоматически оптимизирует ваш промпт для лучших результатов генерации.

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

string
URL изображения для первого кадра (jpg / jpeg / png / gif / bmp)При передаче изображение используется как начальный кадр видео.
string
URL изображения для последнего кадра (jpg / jpeg / png / gif / bmp)При передаче изображение используется как конечный кадр видео. Можно комбинировать с first_frame_image для управления первым и последним кадрами.
object[]
Список промежуточных ключевых кадров, до 6. Каждый элемент имеет следующую структуру:

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

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

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

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

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

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

Ответ

integer
Код статуса ответа, 200 при успехе
array
Массив данных ответа

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

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

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

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

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

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

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

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

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

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

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

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