Введение
Kling 3.0 Motion Control принимает одно чёткое фото персонажа (image_url) и управляющий клип (video_url, от 3 до 30 секунд) и повторяет движения, мимику и жесты рук из управляющего клипа на этом персонаже, сохраняя его лицо, наряд и обстановку с фото. Результат идёт ровно столько же, сколько управляющий клип, и оплачивается по этой длине, а не по выбранной вами длительности. prompt необязателен — используйте его для всего, чего не показывает управляющий клип, например обстановки или образа.
Выбор режима Kling 3.0 по стартовому материалу
| Что у вас есть на старте | Режим |
|---|---|
| текстовое описание сцены или сценарий | Kling 3.0 текст в видео |
| первый кадр и, при желании, последний | Kling 3.0 изображение в видео |
| фото персонажа и управляющий клип | Kling 3.0 Motion Control (вы здесь) |
Ключевые возможности и особенности
Одно фото, один управляющий клип, одно и то же исполнение дважды
Снимите или лицензируйте один управляющий клип — танец, походку, жест — и прогоните его через столько фото персонажей, сколько нужно. В нашем тесте одна и та же связка из управляющего клипа вернулась совпадающей такт в такт на двух разных персонажах, каждый из которых сохранил своё лицо, одежду и фон.
Результат идёт столько же, сколько управляющий клип
Поля длительности здесь нет: длина результата всегда совпадает с управляющим клипом, от 3 до 30 секунд, и оплата следует той же длине.
720p или 1080p
Motion Control не доходит до 4K. Разрешение меняет цену так же, как и на остальных эндпоинтах Kling 3.0.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Нет | Необязательно. Используйте только для того, чего не показывает управляющий клип — обстановки, образа, чего-либо ещё для добавления. Не более 2500 символов |
negative_prompt | Нет | То, чего не должно быть в ролике, — объекты, стилистика или движения, до 2500 символов. Необязательно; на цену не влияет. Не более 2500 символов |
image_url | Да | Персонаж для анимации: одно чёткое фото человека в полный рост или по пояс. |
video_url | Да | Управляющий клип, от 3 до 30 секунд: движения, мимика и жесты для копирования. Результат идёт столько же, сколько этот клип, и оплачивается по этой длине. |
resolution | Нет | 720p или 1080p. Более высокий уровень стоит дороже за секунду. |
keep_original_audio | Нет | Сохраняет в результате собственный звук управляющего клипа. Включён по умолчанию. По умолчанию: |
character_orientation | Нет | Куда смотрит персонаж в результате: video (по умолчанию) следует за человеком в управляющем клипе, image — за человеком на вашем фото. |
shot_type | Нет | Как планируются планы: customize (по умолчанию) следует вашим входным данным, intelligent позволяет модели самой спланировать планы. На цену не влияет. |
Стоимость
Оплата по длине управляющего клипа (video_url) с округлением вверх до целой секунды, от 3 до 30 секунд, а не по выбранной вами длительности. Разрешение меняет ставку.
| Спецификация | Стоимость |
|---|---|
| $0.1008 / секунду |
| $0.1344 / секунду |
Сценарии использования
Повторно использовать одно исполнение на разных персонажах
Поставьте хореографию или лицензируйте один управляющий клип один раз, а затем примените его к каждому фото персонажа в серии — танцевальной связке, набору жестов ведущего презентацию продукта, повторяющемуся приветствию — без пересъёмки движения каждый раз.
Придать статичному фото персонажа настоящее, поставленное движение
Вместо того чтобы описывать движение словами и надеяться на конкретный жест, Motion Control позволяет один раз показать точное движение как управляющий клип и применить его точно.
Перенести исполнение в новую обстановку
Используйте необязательный prompt, чтобы поместить персонажа в другую локацию, отличную от фона управляющего клипа, пока само движение остаётся идентичным.
Руководство по промптам и практические советы
Позвольте управляющему клипу нести движение
Промпту не нужно описывать никакое движение — управляющий клип уже его задаёт. Используйте его только для того, чего клип не показывает, например помещения, детали гардероба или настроения.
Держите фото персонажа чётким и с одним субъектом
Чёткое фото одного человека в полный рост или по пояс, хорошо освещённое и без препятствий, даёт Motion Control наиболее точное совпадение. Фото, где персонаж частично скрыт или снят под необычным углом, оставляет модели больше догадок.
Проверьте, что оба входа достаточно широкие
И фото персонажа, и управляющий клип должны быть примерно 720 пикселей или больше по каждой стороне; управляющий клип меньше этого будет отклонён до начала задачи, а не после того, как вы за неё заплатили.
Быстрый старт 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": "kling/3.0/character-animation",
"input": {
"character_orientation": "video",
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"shot_type": "customize",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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.












