Введение
Kling 3.0 Turbo Image to video принимает первый кадр и промпт с описанием того, что происходит дальше, и возвращает клип от 3 до 15 целых секунд со звуком, сгенерированным в тон. Кадр закрепляет весь план: Kling 3.0 Turbo сохраняет человека, наряд и обстановку с вашего изображения и придумывает движение, камеру и звук.
Выбор режима Kling 3.0 Turbo по стартовому материалу
| Что у вас есть на старте | Режим |
|---|---|
| текстовое описание сцены | Kling 3.0 Turbo текст в видео |
| утверждённое первое изображение | Kling 3.0 Turbo изображение в видео |
Ключевые возможности и особенности
Первый кадр закрепляет весь клип
В наших тестах лицо и наряд из первого кадра переносились через весь клип: съёмка от первого лица за руку сквозь ночной рынок сохранила лицо той же спутницы на протяжении всего прогона, а пара на скутере сохранила куртки и цвет байка от первого кадра до последнего. Опишите только то, что происходит после кадра.
Звук приходит синхронно с движением
Поля aspect_ratio на этом эндпоинте нет — форма кадра клипа следует за вашим исходным изображением, так что обрежьте его до нужной формы перед загрузкой. Звук рендерится всегда и в наших тестах совпадал с видимым действием: звук двигателя и ветер в клипе со скутером, шум рынка и выкрикнутая реплика в клипе с ночным рынком.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Опишите только то, что происходит после кадра: действие, движение камеры и, поскольку звук всегда рендерится, реплики или фоновый звук. Не менее 1 символов · Не более 2500 символов |
image_url | Да | Первый кадр. Человек, наряд и обстановка на этом изображении держатся весь клип — новыми будут только движение, камера и звук. |
resolution | Нет | 720p или 1080p. Более высокие уровни стоят дороже за секунду. |
duration_seconds | Нет | Целые секунды, от 3 до 15. Влияет на цену вместе с разрешением. |
Стоимость
Оплата за секунду выходного видео; разрешение и длительность оба влияют на ставку.
| Спецификация | Стоимость |
|---|---|
| $0.112 / секунду |
| $0.14 / секунду |
Сценарии использования
Превратить утверждённый стоп-кадр в движущийся, озвученный такт
Оживите персонажа, продукт или локацию, уже зафиксированные в стоп-кадре, вместо того чтобы описывать всю сцену с нуля, когда точный облик должен быть безупречным.
POV-клипы, начинающиеся с одного кадра
Первого кадра от первого лица плюс короткого промпта о действии достаточно для съёмки от первого лица с репликами и фоновым звуком, который ей соответствует. В нашем тесте с ночным рынком лицо той же спутницы сохранялось на протяжении всей прогулки с камерой в руке, а рыночный гул и выкрикнутая реплика прибыли синхронно с движением.
Оживить кадр с парой или дуэтом
Стоп-кадр с двумя людьми — на велосипеде, за столом, идущими вместе — сохраняет оба лица и наряда, пока промпт задаёт, что они делают и говорят дальше, а это быстрее, чем заново описывать двух людей с чистого промпта в тексте в видео.
Руководство по промптам и практические советы
Описывайте следующий такт, а не всю сцену
Поскольку кадр уже задаёт облик, промпту нужны только движение, камера и звук: что субъект делает дальше, как камера следует за ним и — поскольку звук генерируется всегда — реплики или фоновый звук, который вам нужен. Повторное описание наряда, транспорта или обстановки, которые кадр уже показывает, лишь тратит слова, которые модель могла бы потратить на действие.
Назовите источник звука, который действительно есть в кадре
В наших тестах звук, привязанный к чему-то видимому — двигателю, ветру, рыночному гулу, — рендерился более стабильно, чем общая подсказка настроения. Если в кадре скутер или толпа, назовите звук, который эта сцена реально производила бы, а не описывайте атмосферу, для которой на экране нет ничего, что её создаёт.
Обрезайте изображение до загрузки
Поля для выбора соотношения сторон здесь нет: результат принимает форму вашего исходного изображения. Обрежьте его до 16:9, 9:16 или квадрата перед загрузкой, если форма кадра для вас важна.
Быстрый старт 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-turbo/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",
"resolution": "720p"
}
}'
# 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.











