Введение
Kling 3.0 Image to video принимает первый кадр (image_url) и промпт с описанием того, что происходит после него, и возвращает от 3 до 15 секунд в 720p, 1080p или 4K. Задайте last_image_url, чтобы также зафиксировать последний кадр, тогда клип должен прийти в конкретную точку, а не просто откуда-то начаться. Включите generate_audio для реплик и атмосферы, генерируемых вместе с картинкой.
Выбор режима Kling 3.0 по стартовому материалу
| Что у вас есть на старте | Режим |
|---|---|
| текстовое описание сцены или сценарий | Kling 3.0 текст в видео |
| первый кадр и, при желании, последний | Kling 3.0 изображение в видео (вы здесь) |
| фото персонажа и управляющий клип | Kling 3.0 Motion Control |
Ключевые возможности и особенности
Первый кадр и, если вы его зададите, последний
Клип начинается с вашего изображения ровно таким, какое оно есть. Добавьте last_image_url, и Kling будет двигаться к этому кадру вместо открытой концовки — в нашем тесте прогулки по окутанному туманом пирсу последний кадр клипа почти точно совпал с заданным финальным изображением, вплоть до красного шарфа.
Кадр определяет облик, промпт определяет движение
Описывайте только действие, камеру и звук — не гардероб и не обстановку, которые уже зафиксировал первый кадр. Наш пример с молнией на заправке ни разу не описывает заново женщину или заправочную станцию из кадра; он только добавляет удар молнии, её шаг под дождь и гром.
Соотношение сторон следует за кадром
Отдельного поля aspect_ratio здесь нет: результат принимает форму вашего первого изображения, от широкого пейзажа до вытянутого портретного кадра.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Опишите только то, что происходит после первого кадра — действие, камеру и, при включённом звуке, звук. Не менее 1 символов · Не более 2500 символов |
negative_prompt | Нет | То, чего не должно быть в ролике, — объекты, стилистика или движения, до 2500 символов. Необязательно; на цену не влияет. Не более 2500 символов |
image_url | Да | Первый кадр. Клип начинается с этого изображения и берёт от него соотношение сторон. |
last_image_url | Нет | Необязательный последний кадр. На длинных клипах середина может «плыть» сильнее, чем удерживаются края. |
resolution | Нет | 720p, 1080p или 4K. Более высокие уровни стоят дороже за секунду. |
generate_audio | Нет | Добавляет сгенерированную звуковую дорожку к тому же клипу. В 720p и 1080p это дороже за секунду, чем без звука; в 4K цена одинакова со звуком и без. По умолчанию: |
duration_seconds | Нет | Целые секунды, от 3 до 15. Влияет на цену. |
shot_type | Нет | single удерживает одну установку камеры в основном ходе, но всё же может сделать склейку сама; multi позволяет Kling самой смонтировать несколько планов. |
multi_prompt | Нет | Список планов для |
guidance_scale | Нет | Насколько точно ролик следует промпту, от 0 до 1 (по умолчанию 0,5). Чем выше, тем ближе к тексту; чем ниже, тем больше свободы у модели. |
Стоимость
Оплата за секунду выходного видео. Разрешение и переключатель звука оба меняют ставку.
| Разрешение | Генерировать аудио: Нет | Генерировать аудио: Да |
|---|---|---|
| $0.0672 / секунду | $0.1008 / секунду |
| $0.0896 / секунду | $0.1344 / секунду |
| $0.336 / секунду | $0.336 / секунду |
Сценарии использования
Продолжить персонажа именно таким, каким он задуман
Когда человек должен выглядеть одинаково от клипа к клипу, сначала сгенерируйте или выберите стоп-кадр, а затем оживите его здесь, вместо того чтобы писать новый text-to-video промпт, который снова оставит гардероб и лицо на волю случая.
Привести клип к конкретной концовке
Задайте последний кадр, когда важен последний такт плана — застывшее выражение лица, рука на двери, фигура, попадающая в фокус, — вместо того чтобы оставлять концовку на усмотрение модели.
Проверить продукт или образ в движении
Стоп-кадра продукта или наряда с промптом на простое движение камеры достаточно, чтобы увидеть, как статичное изображение выглядит в движении и, при включённом звуке, звучит.
Руководство по промптам и практические советы
Описывайте только то, чего кадр ещё не показывает
Наш пример с молнией на заправке держится только того, что происходит после стоп-кадра: вспышка, её шаг с грузовика, уход под ливень. Он ни разу не повторяет её наряд или обстановку — оба уже зафиксированы изображением.
Зафиксируйте план, когда важна непрерывность
За 15 секунд деталь на фоне может «поплыть». Если конкретный предмет или расположение должны оставаться на месте, назовите это прямо («тот же красный грузовик остаётся припаркованным позади неё всё время»), а не полагайтесь на то, что первый кадр зафиксирует это на весь клип.
Пишите «один непрерывный план, без склеек» для неразрывного дубля
Наш пример с перилами яхты на первой попытке переключился на второй ракурс и сменил сумерки на дневной свет; добавление этой фразы в начало промпта вместе с описанием неизменного света удержало и кадрирование, и цвет на протяжении всего клипа при повторном тесте.
Быстрый старт 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/image-to-video",
"input": {
"duration_seconds": 5,
"generate_audio": false,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"shot_type": "single"
}
}'
# 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.












