Kling 3.0 · Video

model: kling-3.0/video

POST https://api.cr-api.ru/api/v1/jobs/createTask

Видео от 3 до 15 секунд по тексту или по первому и последнему кадру. Режимы std, pro и 4K, звук по желанию, до пяти сцен в одном ролике и до трёх персонажей-элементов. Цена — за секунду, зависит от режима и звука.
Примеры результатов и доля успешных задач за 24 часа — на странице модели.

Цена

mode = std, sound = false	11,33 ₽ / с
mode = std, sound = true	17,03 ₽ / с
mode = pro, sound = false	15,15 ₽ / с
mode = pro, sound = true	22,65 ₽ / с
mode = 4K	56,63 ₽ / с

Списывается цена за секунду, умноженная на duration.

Пример запроса ниже стоит 56,63 ₽.

Тело запроса

Поле	Тип	Обязательное	Что это
`model`	string	да	`kling-3.0/video`
`input`	object	да	Параметры модели, таблица ниже
`callBackUrl`	string (URL)	нет	Адрес для результата, до 2048 символов
`maxPrice`	number	нет	Предел цены в рублях: дороже — задача не создаётся (code 422)

Параметры input

Параметр	Тип	Обязательный	Значения
prompt	string	нет	длина 1–2500
image_urls	array of string (URL)	нет	элементов 1–2
sound	boolean	да	—
duration	string	да	одно из: "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15"
aspect_ratio	string	нет	одно из: "16:9", "9:16", "1:1"
mode	string	да	одно из: "std", "pro", "4K"
multi_shots	boolean	да	—
multi_prompt	array of object	нет	элементов 1–5; поля элемента: prompt, duration
kling_elements	array of object	нет	элементов 0–3; поля элемента: name, description, element_input_urls, element_input_audio_urls, start_time, end_time

Пример запроса

curl -X POST "https://api.cr-api.ru/api/v1/jobs/createTask" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-3.0/video",
  "input": {
    "prompt": "A paper boat drifting down a rainy street, cinematic",
    "duration": "5",
    "aspect_ratio": "16:9",
    "mode": "std",
    "sound": false,
    "multi_shots": false
  }
}'

const res = await fetch("https://api.cr-api.ru/api/v1/jobs/createTask", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "kling-3.0/video",
    "input": {
      "prompt": "A paper boat drifting down a rainy street, cinematic",
      "duration": "5",
      "aspect_ratio": "16:9",
      "mode": "std",
      "sound": false,
      "multi_shots": false
    }
  }),
});
const result = await res.json();
console.log(JSON.stringify(result, null, 2)); // data.taskId — идентификатор задачи

import requests

response = requests.post(
    "https://api.cr-api.ru/api/v1/jobs/createTask",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "model": "kling-3.0/video",
        "input": {
            "prompt": "A paper boat drifting down a rainy street, cinematic",
            "duration": "5",
            "aspect_ratio": "16:9",
            "mode": "std",
            "sound": False,
            "multi_shots": False,
        },
    },
)
print(response.json())  # data.taskId — идентификатор задачи

Ответ

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "3f9c2a7be41d4c0c9a7d5e2b1c8f0a64",
    "recordId": "3f9c2a7be41d4c0c9a7d5e2b1c8f0a64"
  }
}

Сумма задачи резервируется сразу. Если генерация не удалась, резерв возвращается. Повтор с заголовком Idempotency-Key не создаст вторую задачу (Все модели).

Результат

Статус и ссылки на файлы — Статус задачи. Ссылки — в resultJson.resultUrls, файлы хранятся 14 дней.

curl "https://api.cr-api.ru/api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch("https://api.cr-api.ru/api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const result = await res.json();
console.log(JSON.stringify(result, null, 2)); // data.state, data.resultJson

import requests

response = requests.get(
    "https://api.cr-api.ru/api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())  # data.state, data.resultJson

Задача выполнена

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "3f9c2a7be41d4c0c9a7d5e2b1c8f0a64",
    "model": "kling-3.0/video",
    "state": "success",
    "param": "{\"input\":\"{\\\"prompt\\\":\\\"A paper boat drifting down a rainy street, cinematic\\\",\\\"duration\\\":\\\"5\\\",\\\"aspect_ratio\\\":\\\"16:9\\\",\\\"mode\\\":\\\"std\\\",\\\"sound\\\":false,\\\"multi_shots\\\":false}\",\"model\":\"kling-3.0/video\"}",
    "resultJson": "{\"resultUrls\":[\"https://files.cr-api.ru/Qm3xV8rTt1ZbW0kq7Lr2aA.png\"]}",
    "failCode": null,
    "failMsg": null,
    "costTime": 14,
    "completeTime": 1762941614000,
    "createTime": 1762941600000,
    "updateTime": 1762941614000,
    "creditsConsumed": 56.63
  }
}

Callback

Если в запросе был callBackUrl, после завершения на него придёт POST с тем же объектом. Доставка и подпись — Callback и проверка подписи.

Тело callback

{
  "code": 200,
  "msg": "Task completed successfully.",
  "data": {
    "taskId": "3f9c2a7be41d4c0c9a7d5e2b1c8f0a64",
    "model": "kling-3.0/video",
    "state": "success",
    "param": "{\"input\":\"{\\\"prompt\\\":\\\"A paper boat drifting down a rainy street, cinematic\\\",\\\"duration\\\":\\\"5\\\",\\\"aspect_ratio\\\":\\\"16:9\\\",\\\"mode\\\":\\\"std\\\",\\\"sound\\\":false,\\\"multi_shots\\\":false}\",\"model\":\"kling-3.0/video\"}",
    "resultJson": "{\"resultUrls\":[\"https://files.cr-api.ru/Qm3xV8rTt1ZbW0kq7Lr2aA.png\"]}",
    "failCode": null,
    "failMsg": null,
    "costTime": 14,
    "completeTime": 1762941614000,
    "createTime": 1762941600000,
    "updateTime": 1762941614000,
    "creditsConsumed": 56.63
  }
}