Введение
Kling 4.0 Flash в режиме reference-to-video создаёт новую сцену 720p по обязательному промпту и переданным референсам. Добавьте до 10 изображений и до 5 видеоклипов общей длительностью 20 секунд. Обозначайте изображения как @Image1, видео как @Video1 и продолжайте нумерацию в порядке загрузки.
Объясните в промпте вклад каждого референса. В примере пустыни одно изображение задаёт персонажа, а два видео определяют движение камеры в сумеречной сцене. Новые клипы длятся 3–20 целых секунд, по умолчанию 5 секунд, и включают синхронизированный звук; keep_original_audio позволяет оставить звук видеореференса. Аудиофайлы в качестве референсов не принимаются.
Ключевые возможности и особенности
- Задайте роли для максимум 10 референсных изображений: персонажи, предметы или детали сцены.
- Направляйте движение и композицию с помощью максимум 5 видео общей длительностью не более 20 секунд.
- Связывайте описание сцены с переданными файлами через обозначения @Image1 и @Video1.
- Создавайте результат 720p на 3–20 секунд со звуком либо сохраняйте звук видеореференса через
keep_original_audio. - Используйте auto для формата входных материалов или выберите 16:9, 9:16, 1:1 либо 21:9.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательные указания для сцены, без готового текста. Назначьте роли @Image1, @Image2, @Video1 и последующим загрузкам. Не менее 1 символов |
reference_image_urls | Нет | Передайте до 10 URL изображений и обозначайте их @Image1, @Image2 и далее по порядку загрузки. Они направляют создание сцены без изменения цены. Не менее 1 элементов · Не более 10 элементов |
reference_video_urls | Нет | Передайте до 5 URL видео общей длительностью 20 секунд и обозначайте их @Video1, @Video2 и далее. Не менее 1 элементов · Не более 5 элементов |
aspect_ratio | Нет | Выберите auto для формата референсов либо 16:9, 9:16, 1:1 или 21:9. Форма кадра не влияет на посекундную ставку и не добавляет платы. |
keep_original_audio | Нет | Установите true, чтобы оставить звук видеореференса, или false, чтобы создать новую дорожку. Параметр действует при наличии видеореференса. По умолчанию: |
duration_seconds | Нет | Длительность результата задаётся целым числом секунд от 3 до 20; по умолчанию — 5 секунд. Она определяет итоговую сумму через оплачиваемую длительность видео. |
Стоимость
$0.113 / секунда
Генерация по референсам оплачивается за секунду результата. При добавлении видеореференса к длительности результата применяется повышенная ставка за секунду; длительность самого референса отдельно не оплачивается. Изображения, формулировка промпта, соотношение сторон и keep_original_audio не добавляют отдельной платы. Запросы, отклонённые модерацией Kling, не оплачиваются.
Сценарии использования
- Перенесите персонажа с изображения в сцену пустыни для соцсетей, задав движение короткими клипами.
- Проверьте сочетание персонажа и локации с помощью отдельно обозначенных изображений.
- Подготовьте несколько коротких черновиков сцены с выбранным движением камеры для обсуждения контента.
Руководство по промптам и практические советы
- Перед описанием новой сцены определите роль каждого изображения, например «@Image1 задаёт персонажа».
- Объясните, что взять из видео, например «используйте медленное приближение камеры из @Video1», чтобы назначение референса было понятно.
- Опишите новую обстановку, например «тихая пустыня в сумерках», чтобы отделить желаемую сцену от исходных материалов.
- Для 3-секундного черновика задайте краткое действие, например «путешественник останавливается у указателя».
- При создании новой дорожки добавьте звуковой ориентир, например «Звук: сухой ветер и далёкий поезд».
Быстрый старт 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/4.0-flash/reference-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 5,
"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.
