Введение
Для video-edit в Kling 4.0 Flash нужны готовый клип и обязательная инструкция с описанием правки. Передайте исходник на 3–20 секунд и при необходимости до 10 референсных изображений. Результат в 720p применяет указанное изменение, сохраняя сцену, персонажа, действие и движение камеры исходника.
Длительность результата равна исходной; исходники длиннее 20 секунд обрезаются на этой отметке. В наших тестах после замены одежды в обсерватории клип сохранил исходные 5,04 секунды. Звук исходника остаётся по умолчанию; для новой синхронизированной дорожки установите keep_original_audio в false.
Ключевые возможности и особенности
- Меняйте визуальную часть готового выступления, сохраняя движение камеры.
- Добавьте до 10 изображений, если для правки нужен конкретный визуальный референс.
- Сохраняйте исходный тайминг в результате; исходный материал ограничен 20 секундами.
- Оставьте исходную дорожку по умолчанию либо создайте новый синхронизированный звук.
- Получите видео 720p с форматом кадра auto или одним из четырёх доступных соотношений сторон.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательная инструкция для правки, без готового текста. Опишите изменение и сцену, персонажа, действие и движение камеры, которые следует сохранить. Не менее 1 символов |
video_url | Да | Обязательный URL одного исходного клипа на 3–20 секунд; готового исходника нет. Более длинное видео обрезается до 20 секунд. Не менее 1 символов |
reference_image_urls | Нет | При желании добавьте до 10 URL изображений для направления правки; обозначайте их @Image1, @Image2 и далее в порядке загрузки. Референсные изображения отдельно не оплачиваются. Не менее 1 элементов · Не более 10 элементов |
aspect_ratio | Нет | Используйте auto для формата исходного видео либо задайте 16:9, 9:16, 1:1 или 21:9 для результата. Этот параметр не меняет стоимость правки. |
keep_original_audio | Нет | Стандартное значение true сохраняет исходный звук; false создаёт новую синхронизированную дорожку. Изменение значения отдельно не оплачивается. По умолчанию: |
Стоимость
$0.151 / секунда
Редактирование оплачивается по секундам исходника с округлением вверх до следующей целой секунды, максимум за 20 секунд. Исходник на 5,04 секунды считается как 6 оплачиваемых секунд, даже если результат остаётся длиной 5,04 секунды. Промпт, референсные изображения, соотношение сторон и выбор звука отдельно не оплачиваются. При отклонении модерацией Kling списания нет.
Сценарии использования
- Примерьте изумрудное вечернее платье в клипе из обсерватории, сохранив действие.
- Сравните разные цвета пальто в версиях короткой сцены для соцсетей.
- Подготовьте визуальные варианты черновика с записанным движением и сохранённой исходной дорожкой.
Руководство по промптам и практические советы
- Начните с того, что нужно оставить, например «сохраните сцену и движение камеры», чтобы задать неизменные элементы.
- Укажите точечную правку, например «сделайте пальто тёмно-серым», прежде чем запрашивать несколько вариантов.
- Объясните роль каждого добавленного изображения, например «используйте куртку с @Image1», чтобы связать референс с правкой.
- При замене одежды описывайте материал и цвет вместе, например «изумрудное бархатное платье».
- Для новой дорожки выключите
keep_original_audioи добавьте указание, например «Звук: низкий гул мотора и вечерний ветер».
Быстрый старт 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/video-edit",
"input": {
"aspect_ratio": "auto",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"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.
