Введение
Загрузите клип с движением и добавьте до 10 референсных изображений или опишите персонажа. Длина результата соответствует клипу.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Видео |
| Задача | Анимация персонажа по видео с движением |
| Обязательный источник | URL видео с движением; клип до 30 секунд |
| Референсные изображения | Необязательны; до 10; изображение в начале определяет исполнителя |
| Промпт | От 1 до 2,000 символов при передаче; обязателен без изображений |
| Высота выходного видео | 480p или 720p; по умолчанию 720p |
| Тарифы по разрешению | 720p стоит вдвое дороже 480p |
| Управление звуком | По умолчанию создаётся новый звук; отключите для сохранения исходного |
| Управление через видео | Результат следует длительности, камере и фону источника |
| Основа расчёта | За каждую начатую секунду видео с движением; минимум четыре секунды |
| Неудачные запуски | Без оплаты |
| Записанный результат | MP4 480 x 854; 4.71 секунды из клипа на 5 секунд |
Ключевые возможности и особенности
Композиция в исполнении референсного персонажа
Одно изображение персонажа и управляющий клип на 5 секунд дали выступление в серой студии в 480p. MP4 имел размер 480 x 854 пикселя и длился 4.71 секунды. При планировании монтажа с заданным хронометражем учитывайте эту длительность вместе с входной: записанный результат короче источника.
Выберите исполнителя и покажите движения
Клип задаёт движения, камеру и фон. Поместите изображение исполнителя в начало списка из максимум 10 изображений или задайте персонажа текстом, если изображений нет. Промпт также может добавлять указания в запрос с изображениями.
Осознанно настройте разрешение и аудио
Высота выходного видео — 480p или 720p. По умолчанию выбрано 720p по двойному тарифу относительно 480p. Генерация звука также включена по умолчанию. Отключите её, если выступление должно сопровождаться звуком управляющего клипа.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
video_url | Да | Клип с движением, до 30 секунд. Менее 4 секунд оплачивается как 4. Не менее 1 символов |
reference_image_urls | Нет | До 10 изображений. Первое задаёт персонажа, выполняющего движение. Не более 10 элементов |
prompt | Нет | Дополнительное указание. Обязательно, если нет изображений. Не менее 1 символов · Не более 2000 символов |
resolution | Нет | 480p или 720p (по умолчанию). 720p стоит вдвое дороже. |
generate_audio | Нет | Включено по умолчанию. Если выключить, сохранится звук клипа с движением. По умолчанию: |
Стоимость
Motion Control Flash оплачивается за каждую начатую секунду видео с движением, минимум четыре секунды. Незавершённые запуски не оплачиваются.
| Спецификация | Стоимость |
|---|---|
| $0.162 / секунду |
| $0.324 / секунду |
Сценарии использования
Студийные исследования хореографии
Совместите клип с композицией и изображение персонажа, чтобы оценить исполнение движений. Наш пример в серой студии дал MP4 размером 480 x 854 в 480p длительностью 4.71 секунды из источника на 5 секунд.
Репетиции жестов ведущего
Используйте записанный жест ведущего как референс движения и добавьте изображение персонажа. Выберите запись с нужными камерой и фоном презентации, затем проверьте полученные жесты до монтажа.
Концепции персонажей по описанию
Опишите инструктора мастерской, экскурсовода галереи или другого специалиста в обычной рабочей одежде, затем передайте запись выступления. Если у вас нет изображений для загрузки, персонажа определяет промпт.
Выступления с готовым звуком
Сохраните композицию вместе с её звуком, отключив генерацию аудио. Проверьте полученные звук и видео вместе перед включением выступления в более длинную последовательность.
Руководство по промптам и практические советы
Выберите запись выступления
Укажите URL видео с движением до 30 секунд. Подберите запись, чьи действия, камера и фон подходят для задуманного результата.
Определите исполнителя
Добавьте до 10 изображений с изображением персонажа в начале либо опишите персонажа в обязательном промпте, если изображения не используются.
Настройте размер изображения и звук
Выберите 480p или 720p. По умолчанию выбрано 720p по двойному тарифу относительно 480p. Оставьте генерацию звука включённой для нового аудио или отключите её, чтобы сохранить звук клипа движения.
Проверьте полученное выступление
Сопоставьте движения, внешность персонажа и полученную длительность с источником. В нашем студийном примере клип на 5 секунд дал 4.71 секунды, поэтому проверьте результат перед размещением на монтажной шкале.
Управляйте персонажем с помощью записанного выступления
Анимация персонажей Motion Control Flash принимает видео с движением и воспроизводит выступление персонажа, заданного изображениями или описанием. Управляющий клип определяет движения, камеру и фон. Выбирайте этот процесс, если у вас уже есть запись действия для повторного использования.
Видео с движением необходимо даже при текстовом описании персонажа. Промпт добавляет указания; он не заменяет записанное выступление.
Параметры запроса
При подготовке запроса отделяйте источник выступления от референса персонажа. Эти настройки задают входные материалы, высоту выходного видео и обработку звука.
| Параметр | Требования и варианты | Роль в запросе |
|---|---|---|
video_url | Обязательная непустая строка; клип движения до 30 секунд | Задаёт выступление, камеру, фон и референсную длительность. |
reference_image_urls | Необязательный массив; до 10 изображений | Изображение в начале списка определяет персонажа, выполняющего движения. |
prompt | Необязателен с изображениями; обязателен без них; от 1 до 2,000 символов при передаче | Описывает персонажа или добавляет указания. |
resolution | 480p или 720p; по умолчанию 720p | Выбирает высоту выходного видео; 720p стоит вдвое дороже 480p. |
generate_audio | Логическое значение; по умолчанию true | При включении создаёт новый звук; при выключении сохраняет звук клипа движения. |
Задайте персонажа изображениями или текстом
Поместите изображение нужного исполнителя в начало списка референсов. Можно добавить до 10 изображений. Проверьте порядок перед отправкой, чтобы нужный исполнитель оставался в начале списка.
Без изображений напишите описание персонажа в промпте. Полезный черновик указывает профессию, обычную одежду и роль персонажа в сцене. Для запроса с изображениями назовите изображённого персонажа и добавьте важные указания, а не описание постороннего выступления.
Выберите клип до написания промпта
Поскольку результат следует камере и фону источника, начните с записи, чьи кадрирование и обстановка подходят задуманному видео. Обрежьте источник до нужного действия в пределах входного лимита 30 секунд. Просмотрите запись целиком перед отправкой и решите, какие движения будете проверять в полученном выступлении.
Дайте промпту конкретную задачу
В записанном запросе использовалось: "The character from image 1 performs the routine in a warm grey photo studio." Этот текст связывает изображённого персонажа с композицией и называет обстановку, не перечисляя новую последовательность движений. Сохраняйте такое разделение ролей в собственных указаниях: клип демонстрирует выступление, а текст определяет или уточняет персонажа.
Выберите источник, соответствующий описанной обстановке. Управляющий клип задаёт фон, поэтому описание сцены должно согласовываться с источником. Ограничьте промпт 2,000 символами и сохраните его с выбранными входными материалами для последующего просмотра.
Разрешение, звук и стоимость
Используйте цену, показанную на этой странице для выбранного разрешения. Оплачивается каждая начатая секунда видео с движением, минимум четыре секунды; неудачные запуски не оплачиваются. Основа расчёта — входное видео с движением, поэтому не оценивайте её по длительности полученного файла.
Высота выходного видео по умолчанию — 720p. Осознанно выбирайте 480p, если эта высота подходит вашему черновику; 720p стоит вдвое дороже. Наш студийный пример дал вертикальный MP4 размером 480 x 854 пикселя в 480p.
Решите, сохранять ли исходный звук
Генерация звука изначально включена. Оставьте её включённой, если нужен новый звук, или задайте generate_audio значение false, чтобы использовать звук клипа движения. Прослушайте полученный файл перед использованием в монтаже.
Композиция в серой студии
18 ноября 2026 года мы отправили управляющий клип на 5 секунд с одним референсным изображением, приведённым выше студийным промптом и выбранным 480p. Полученный MP4 показывал референсного персонажа, исполняющего композицию в серой студии. Размер составил 480 x 854 пикселя, длительность — 4.71 секунды.
Полученная длительность оказалась короче исходной. Проверьте длительность медиа перед совмещением результата с другой дорожкой или вставкой в последовательность с заданным хронометражем. Сопоставьте начало и конец действия с источником, затем используйте фактическую длину полученного файла при организации монтажа.
Ограничения и родственные варианты
Подготовьте клипы движения до 30 секунд, не более 10 референсных изображений и промпт в пределах указанного лимита символов. Проверьте движения, внешний вид, кадрирование и звук в полученном файле. Храните входной клип, референсы персонажа и промпт вместе, чтобы понимать, что менять в следующей версии.
Сравните другое семейство при других входных материалах
Если у вас нет подходящего клипа движения, изучите процесс работы Kling 3.0 до выбора эндпоинта. При сравнении с другим семейством анимации персонажей изучите Wan 2.2 Animate и проверьте обязательные входные материалы и настройки выхода. Выбирайте по имеющемуся исходному материалу и средствам управления, нужным для вашей сцены.
Выберите клип движения, чьи выступление, камера и фон подходят для задуманной сцены.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/motion-control-flash/character-animation",
"input": {
"resolution": "720p",
"video_url": "https://example.com/reference.mp4",
"reference_image_urls": [
"https://example.com/reference.png"
]
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.


