Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
character_orientation | Нет | Which way the character faces: video follows the person in the driving clip, image follows the person in the photo. With image the driving clip may be at most 10 seconds. video · image · По умолчанию: video |
image_url | Да | Картинка, с которой всё начинается. |
keep_original_audio | Нет | Keep the driving clip's own sound in the result. По умолчанию: true |
negative_prompt | Нет | Чего не должно быть в кадре. |
prompt | Нет | Optional notes on the result: the setting, the look, anything the driving clip does not show. |
resolution | Нет | Размер результата. Больше — чётче и дороже. 720p · 1080p · По умолчанию: 720p |
shot_type | Нет | How the shots are planned: customize keeps to your inputs, intelligent lets the model plan the shots itself. customize · intelligent · По умолчанию: customize |
video_url | Да | Ролик, с которым работаем. |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за секунду | ≈ USD |
|---|---|---|
| resolution 720p | 15,12 | 0,15 $ |
| resolution 1080p | 20,16 | 0,20 $ |
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Kling 3.0 в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model kling/3.0/character-animation и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "kling/3.0/character-animation",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"resolution": "720p",
"character_orientation": "video",
"shot_type": "customize"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Kling 3.0
Сколько стоит API Kling 3.0?
Kling 3.0 стоит от 15,12 кредита (0,15 $) за секунду — на самой дешёвой задаче «Управление движением». Цены по вариантам: 720p 15,12 кредита за секунду, 1080p 20,16 кредита за секунду. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Kling 3.0 в API?
Укажите kling/3.0/text-to-video — Создать видео; kling/3.0/image-to-video — Видео из картинки; kling/3.0/character-animation — Управление движением в поле model запроса POST /jobs/createTask.
Гарантирует ли shot_type single один непрерывный план?
Само по себе — нет. В наших тестах Kling 3.0 иногда делала склейку на второй ракурс даже при выбранном single. Добавьте в промпт фразу вроде «один непрерывный план, без склеек», если дубль не должен прерываться — это исправило ситуацию в повторном тесте той же сцены.
Сколько времени занимает генерация клипа?
Kling работает не мгновенно — рассчитывайте на несколько минут на клип, а не на секунды, и дольше для Motion Control и более высоких разрешений. Песочница показывает прогресс, пока задача выполняется.
Какие ограничения у API Kling 3.0?
Разрешения: 720p · 1080p; Длина промпта (символов): 2,500; Максимальный размер загрузки: 10 MB; Максимальная длина входного клипа: 30 s. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Kling 3.0 без кода?
Да. Playground запускает Kling 3.0 на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.
Все модели Kling
Kling O3 — более гибкий собрат: до семи референсных фото в одном кадре, автоматические склейки нескольких планов и правка уже готовых роликов. Kling 3.0 — выбор для одного отполированного дубля с первым и последним кадром или Motion Control.
- Kling 3.0 APIКлипы 4K, мультикадровый монтаж и управление движениемОт 51 кредита за клип длиной 5 с
- Kling O3 APIKling «всё в одном»: создавать, оживлять, по референсам и править до 4KОт 51 кредита за клип длиной 5 с
- Kling 3.0 Turbo APIУскоренный Kling 3.0, звук в каждом клипеОт 84 кредитов за клип длиной 5 с
- Kling Avatar 2.0 APIПортрет говорит или поёт твоё аудио, до 5 минутОт 7,68 кредита за секунду
- Kling 2.6 APIКлипы 1080p, звук и управление движением по желаниюОт 52 кредитов за клип длиной 5 с
- Kling 2.5 Turbo APIКлипы 1080p с саундтреком в каждом дублеОт 42 кредитов за клип длиной 5 с
- Kling 2.1 Master APIБеззвучные клипы 1080p с тонкой настройкой промптаОт 162 кредитов за клип длиной 5 с
- Kling 2.1 APIОживляет кадр в 720p или 1080p, можно задать финальный кадрОт 27 кредитов за клип длиной 5 с

