Введение
Kling 2.1 Master Image to video оживляет первый кадр в клип на 5 или 10 секунд в 1080p, без звуковой дорожки и без опции последнего кадра на этом эндпоинте — только image_url.
Выбор режима Kling 2.1 Master по стартовому материалу
| Что у вас есть на старте | Режим |
|---|---|
| текстовое описание сцены | Kling 2.1 Master текст в видео |
| утверждённый первый кадр | Kling 2.1 Master изображение в видео |
Ключевые возможности и особенности
Кадр держится, промпт даёт движение
Гардероб, поза, свет и обстановка первого кадра остаются такими же, как отправлены; промпту нужно только описать, что происходит дальше и куда движется камера. В наших тестах застывшая океанская волна и подводное бальное платье убедительно оживали прямо из одного стоп-кадра, при этом кадрировка и костюм оставались нетронутыми.
На этом эндпоинте нет последнего кадра
В отличие от стандартного image-to-video Kling 2.1, image-to-video в Master принимает только image_url, без last_image_url. Если важна конкретная финальная поза, опишите её прямо в промпте и дайте модели двигаться к ней, а не рассчитывайте, что второй кадр зафиксирует финал.
На вертикальных кадрах лицо может выйти мельче
Когда первый кадр — вертикальный кроп, рендер следует этому формату, и в одном из наших тестов лицо получилось мельче и чуть менее детализированным, чем при горизонтальном кадре. Более плотный кроп лица на вертикальном первом кадре переносит больше деталей в готовый клип.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Опишите только то, что происходит после первого кадра: действие и движение камеры. Не менее 1 символов · Не более 5000 символов |
image_url | Да | Первый кадр. Только JPEG или PNG. |
duration_seconds | Нет | Целые секунды, 5 или 10. Влияет на цену. |
negative_prompt | Нет | Короткий список того, чего клипу следует избегать — полезно, чтобы увести от типичных сбоев рендера на сложных движениях камеры. Не более 500 символов |
guidance_scale | Нет | От 0 до 1. Выше — ближе к вашей формулировке; ниже даёт модели больше свободы. |
Стоимость
$0.216 / секунда
Оплата за секунду выходного клипа. Загрузка, которую Kling отклоняет, не оплачивается.
Сценарии использования
Довести конкретный стоп-кадр до движения высшего качества
Используйте этот уровень, когда первый кадр уже абсолютно верен — свет, гардероб, поза — и рендер должен стать финальным вариантом, а не черновиком для сравнения с более дешёвыми дублями.
Атмосферное движение: ткань, вода, огонь, пыль
Струящиеся платья, накатывающие волны, парящая дымка и раскачивающаяся люстра рендерились в наших тестах естественно из стоп-кадра плюс промпта, описывающего движение — это подходит для любой сцены, построенной на атмосфере, а не на диалоге или быстром действии.
Второй клип высокой чёткости в том же проекте
Поскольку этот эндпоинт делит с текст-в-видео более высокую цену Master, обращайтесь с ним так же: приберегите его для сцены, уже одобренной в другом месте, а формулировку сначала отточите на более дешёвом уровне.
Руководство по промптам и практические советы
Скажите элементам стоп-кадра, когда двигаться
Укажите на то, что уже есть в кадре — волна, поза, наряд, — и опишите порядок, в котором это должно ожить, вместо того чтобы заново описывать всю сцену. Модель уже знает, как выглядит изображение.
Сочетайте negative_prompt с облетающей или дрейфующей камерой
Короткий negative_prompt, называющий, например, размытые лица или искажённые руки, — дешёвый способ увести медленную орбиту или дрейф в стиле подводной съёмки от более частых сбоев рендера этой модели, особенно когда клип идёт все 10 секунд.
На вертикальных кадрах кадрируйте лицо чуть плотнее
Если первый кадр — вертикальный кроп, возьмите лицо крупнее, чем взяли бы для горизонтальной сцены; широкий вертикальный кроп может сделать лицо мелким, когда клип придёт в движение — так и произошло в одном из наших тестов с вертикальными кадрами.
Быстрый старт 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/2.1-master/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise"
}
}'
# 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.
