Введение
Kling 2.1 Image to video — единственный режим, который предлагает это поколение: отправьте первый кадр и промпт с описанием того, что происходит дальше, выберите resolution — 720p (стандарт) или 1080p (про), — и получите обратно беззвучный клип на 5 или 10 секунд. Последний кадр (last_image_url) принимается только в 1080p.
Выбор разрешения по бюджету
| Что вам нужно | Разрешение |
|---|---|
| самый недорогой уровень в этой линейке | 720p (стандарт) |
| более чёткий клип с необязательным последним кадром | 1080p (про) |
Ключевые возможности и особенности
Последний кадр — только в 1080p
Установите resolution в 1080p и добавьте последний кадр рядом с первым, и клип будет построен так, чтобы на последнем кадре точно попасть в эту позу. В 720p последний кадр не принимается: запрос, который его включает, отклоняется до запуска, без списания оплаты — поэтому не отправляйте его на этом уровне и дайте клипу идти от первого кадра до точки, где модель решит остановиться.
Нет звуковой дорожки ни на одном из уровней
Эта модель вообще не генерирует звук — ни в 720p, ни в 1080p. Это простой факт, который нужно учитывать при планировании, а не недостаток — подходит материалу, который пойдёт в монтаж, где позже добавят свой голос, музыку или звуковой дизайн.
Первый и последний кадры могут стыковаться чисто
В одном из наших тестов проход по пирсу, начинавшийся в тумане и заканчивавшийся близкой позой лицом к камере, приземлился почти точно на заданный последний кадр, а ветер и цветокоррекция оставались согласованными все пять секунд.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Опишите только то, что происходит после первого кадра: действие и движение камеры. Не менее 1 символов · Не более 5000 символов |
image_url | Да | Первый кадр. Только JPEG или PNG. |
last_image_url | Нет | Необязательный последний кадр, принимается только в 1080p. Запрос в 720p, который его включает, отклоняется, без списания оплаты. |
resolution | Нет | 720p (стандарт, самый недорогой уровень) или 1080p (про, единственный уровень, принимающий последний кадр). |
duration_seconds | Нет | Целые секунды, 5 или 10. Влияет на цену. |
negative_prompt | Нет | Короткий список того, чего клипу следует избегать. Не более 500 символов |
guidance_scale | Нет | От 0 до 1. Выше — ближе к вашей формулировке; ниже даёт модели больше свободы. |
Стоимость
Оплата за секунду выходного клипа; профессиональный уровень 1080p стоит дороже за секунду, чем стандартный 720p. Загрузка, которую Kling отклоняет, не оплачивается.
| Спецификация | Стоимость |
|---|---|
| $0.035 / секунду |
| $0.068 / секунду |
Сценарии использования
Самая дешёвая проверка первого кадра
Сначала запустите стандартный уровень 720p, чтобы увидеть, читается ли действие, движение камеры или кадрирование так, как вам нужно, прежде чем тратить больше на более высокий уровень или новое поколение.
Двухкадровая последовательность с зафиксированной концовкой
Используйте профессиональный уровень 1080p с image_url и last_image_url одновременно, когда важна точная финальная поза — например, последний план перед склейкой.
Руководство по промптам и практические советы
Опишите одно непрерывное действие от начала до конца
Пример с мечом на крыше выше называет одну дугу — от взмаха до финальной защитной стойки; такая структура одного такта надёжнее на этом поколении, чем несколько разных действий, втиснутых в один промпт.
Не ждите, что длинные тянущиеся детали сохранят форму
Длинные волосы, волочащаяся ткань или развевающиеся аксессуары — тот вид деталей, который это поколение склонно терять за 10 секунд: длинный бархатный шлейф заметно укоротился к середине одного из наших тестов на лестнице. Держите такие детали короткими или заложите проход ретуши позже.
Подбирайте разрешение под то, что нужно кадру
Сначала сделайте тест в 720p, пока ещё уточняете действие или движение камеры, а уровень pro в 1080p — с его опциональным последним кадром — приберегите для дубля, который хотите оставить.
Быстрый старт 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/2.1/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.
