Введение
Kling O3 Video edit меняет уже готовое видео вместо того, чтобы генерировать новое с нуля. Загрузите исходный клип и напишите промпт, описывающий только то, что должно измениться — сезон, гардероб, фон, стиль, — а всё, что вы не назвали, остаётся таким, как было снято. При желании добавьте до 4 референсных фото, чтобы внести нового персонажа, наряд или предмет. Результат идёт ровно столько же, сколько ваш исходный клип, от 3 до 10 секунд, в 720p или 1080p.
Выбор режима Kling O3 по стартовому материалу
| Что у вас есть на старте | Режим |
|---|---|
| только текстовое описание сцены | Kling O3 текст в видео |
| утверждённый первый кадр | Kling O3 изображение в видео |
| до 7 референсных фото | Kling O3 референс в видео |
| уже готовое видео | Kling O3 редактирование видео |
Ключевые возможности и особенности
Меняется только то, что вы назвали
Промпт — это список изменений, а не полное описание сцены: скажите, что сезон должен смениться на снежный или гардероб — на зимнее пальто, и кадрирование, движение и темп исходного клипа перенесутся без изменений.
Длительность и формат следуют за исходником
Поля длительности здесь нет — отредактированный клип совпадает по длине с загруженным видео, от 3 до 10 секунд, а его разрешение ограничено 720p или 1080p, в отличие от 4K, доступного в остальных трёх режимах.
Референсные фото для того, чего не было в исходнике
Добавьте до 4 референсных изображений, когда правка должна внести то, чего нет в исходном клипе, — конкретный новый наряд, предмет или образ, — наряду с изменениями, описанными в промпте.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Скажите, что изменить — субъект, наряд, обстановку, стиль или погоду. Всё, что вы не упомянули, остаётся в отредактированном клипе как есть. Не менее 1 символов · Не более 2500 символов |
video_url | Да | Исходный клип для редактирования, от 3 до 10 секунд, хотя бы примерно 720 пикселей по короткой стороне. Отредактированный результат идёт ровно столько же, сколько этот клип. |
elements | Нет | Один именованный субъект, которого нужно ввести в отредактированный клип: дайте ему имя, описание в одну строку и 2–4 фото одного и того же человека или предмета (образцы голоса… Не более 1 элементов |
reference_image_urls | Нет | Необязательно, до 4 референсных фото для нового персонажа, наряда, предмета или стиля, вносимого в правку. JPEG или PNG. Не менее 1 элементов · Не более 4 элементов |
resolution | Нет | 720p или 1080p. Более высокий уровень стоит дороже за секунду. |
keep_original_audio | Нет | Сохраняет в отредактированном результате собственный звук исходного клипа. Включён по умолчанию. По умолчанию: |
Стоимость
Оплата за секунду длины вашего исходного видео (от 3 до 10 секунд), по разрешению.
| Спецификация | Стоимость |
|---|---|
| $0.1252 / секунду |
| $0.168 / секунду |
Сценарии использования
Использовать клип повторно в другом сезоне или погоде
Возьмите уже понравившийся план и измените только сезон или погоду — лето на снег, ясное небо на дождь, — не переснимая и не генерируя всю сцену заново с нуля.
Сменить гардероб или фон на уже утверждённом дубле
Когда кадрирование и игра в клипе устраивают, а наряд или локация позади субъекта должны измениться, video-edit обновляет только этот элемент.
Изменить стиль клипа, уже сгенерированного в другом месте
Подайте видео, полученное из text-to-video или image-to-video на этой или другой модели, и с помощью промпта, при необходимости с опорой на референсные фото, придайте ему другой визуальный стиль.
Руководство по промптам и практические советы
Пишите это как список изменений, а не как сцену
Отталкивайтесь от того, что уже есть в клипе, и называйте отличия: «смени сезон на снежный», «одень его в угольно-серое пальто вместо этого». Полное описание сцены подталкивает модель переделать больше, чем вы задумывали.
Сначала проверьте размеры исходного видео
Исходник должен быть примерно 720 пикселей или больше по короткой стороне. Слишком маленький клип будет отклонён ещё до начала генерации, поэтому проверьте это заранее для задания, которое также включает референсные фото.
Добавляйте референсы только для того, что вносит правка
Референсные фото нужны, чтобы внести в кадр что-то новое — наряд, предмет, образ, которого нет в исходнике. Для чисто описательных изменений, вроде сезона или смены цвета, обычно достаточно одного промпта.
Прописывайте гардероб отдельно для каждого человека
Когда в клипе больше одного человека и каждому нужен свой новый наряд, называйте их по отдельности — «велосипедист впереди в тёмно-синем пальто, тот, что сзади, — в сером», а не одним общим описанием. Без уточнения наш зимний тест дал обоим велосипедистам одинаковое пальто.
Быстрый старт 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/o3/video-edit",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"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.












