Kling AI: как пользоваться генерацией видео через API
Kling AI можно пользоваться через API Relay: выбрать модель, отправить описание сцены и сохранить ролик. В зависимости от модели API возвращает готовое видео с HTTP 200 либо задачу с HTTP 202, за которой нужно следить. Это инструкция для своего приложения, а не интерфейса сайта Kling. До оплаченных пополнений на $10 создание видео в Relay недоступно; приветственный бонус в порог не входит.
Kling AI: как пользоваться API для первого ролика?
Откройте каталог видео и выберите kling-v2.6 или kling-v3.0. Скопируйте точный ID и посмотрите цену за секунду. Номер в названии не объясняет, какая модель лучше для вашей сцены.
Создайте ключ Relay в кабинете и передайте его серверному процессу через RELAY_API_KEY. Способы и условия пополнения смотрите на странице цен и в кабинете. У аккаунта должен быть доступный баланс для резерва запроса; снятие ограничения нового аккаунта само по себе не гарантирует, что денег достаточно.
Начните с одного действия: бумажный кораблик плывёт по луже, камера неподвижна. Запишите критерии: один кораблик остаётся в кадре, движется вперёд, надписей нет. Такой тест покажет и работоспособность API, и соответствие промпту.
Как сделать видео в Kling AI и получить файл?
Код использует стандартную библиотеку Python. Он обрабатывает оба формата ответа. Пауза опроса и локальное время ожидания в скрипте выбраны для примера, это не обещание скорости генерации.
import base64
import json
import os
import time
from pathlib import Path
from urllib.error import HTTPError
from urllib.request import Request, urlopen
base = "https://relay-llm.ru/v1"
headers = {
"Authorization": f"Bearer {os.environ['RELAY_API_KEY']}",
"Content-Type": "application/json",
}
def request(method, path, body=None):
data = None if body is None else json.dumps(body).encode("utf-8")
req = Request(base + path, data=data, headers=headers, method=method)
try:
with urlopen(req, timeout=600) as response:
return response.status, response.read()
except HTTPError as exc:
raise RuntimeError(f"HTTP {exc.code}: {exc.read().decode('utf-8')}") from exc
status, raw = request("POST", "/videos", {
"model": "kling-v3.0",
"prompt": "Один бумажный кораблик медленно плывёт по луже. Камера неподвижна, дневной свет, без текста и логотипов.",
"duration_seconds": 8,
})
result = json.loads(raw)
if status == 200:
video = base64.b64decode(result["data"][0]["b64_json"], validate=True)
elif status == 202:
job_id = result["id"]
Path("kling-job-id.txt").write_text(job_id, encoding="utf-8")
print("Задача:", job_id, flush=True)
deadline = time.monotonic() + 1800
while time.monotonic() < deadline:
_, raw = request("GET", f"/videos/{job_id}")
job = json.loads(raw)
if job["status"] == "failed":
raise RuntimeError(json.dumps(job.get("error"), ensure_ascii=False))
if job["status"] == "completed":
_, video = request("GET", f"/videos/{job_id}/content")
break
if job["status"] not in {"queued", "running"}:
raise RuntimeError("Неизвестный статус задачи")
time.sleep(3)
else:
raise TimeoutError(f"Опрос остановлен; сохраните и проверьте задачу {job_id}")
else:
raise RuntimeError(f"Неожиданный HTTP-статус: {status}")
Path("kling-video.mp4").write_bytes(video)Восемь секунд взяты из примера Videos API. Допустимую длительность выбранной модели проверьте перед запуском; предел поля шлюза не означает, что каждая модель принимает любое значение. Если модель имеет длительность по умолчанию, поле можно опустить. Без такого значения оно обязательно.
При ошибке опроса скрипт останавливается, но сохраняет ID в kling-job-id.txt. После устранения причины продолжайте с GET существующей задачи. Например, ответ 429 при проверке статуса требует паузы по заголовкам ответа, а не нового POST. Если файл уже скачан, сначала откройте его локально: ошибка проигрывателя сама по себе не означает неудачную генерацию.
Скрипт не повторяет создание при ошибке. Если соединение оборвалось после отправки POST, исход может быть неопределённым. Сначала проверьте журнал, а при сохранённом ID запросите статус. Повтор POST создаёт новый запрос и может дать дополнительный расход.
Что означают статусы задачи?
| Статус | Действие приложения |
|---|---|
queued | Сохранить ID и проверить позже |
running | Продолжить опрос с паузой |
completed | Скачать содержимое до expires_at |
failed | Прекратить опрос и разобрать объект error |
Статус читается через GET /v1/videos/JOB_ID. Он не запускает новую генерацию и не оплачивается, но подчиняется лимиту служебных запросов. Содержимое выдаёт GET /v1/videos/JOB_ID/content с авторизацией. Скачайте его до срока expires_at: ссылка не служит постоянным хранилищем.
При синхронном HTTP 200 ID задачи отсутствует. Байты уже находятся в data[0].b64_json; опрашивать статус такого результата не нужно.
Что делать, если запрос или ролик не удался?
HTTP 402 new_account_limit требует выполнить условие оплаченных пополнений. Код insufficient_balance относится к доступным средствам, а key_limit_exceeded к лимиту ключа. Пополнение не исправляет исчерпанный лимит ключа автоматически.
При 400 проверьте тело и параметры, при 404 точный ID или путь. Для временного отказа следуйте заголовкам повтора из справочника ошибок. При failed сохраните объект ошибки и прекратите опрос; списания за такую задачу нет.
Если файл готов, но кораблик меняет форму или камера движется, это вопрос результата генерации. Исправьте один пункт промпта и создайте новую попытку. Все успешно созданные ролики учитывайте в расходах, даже если не использовали их в монтаже.
Kling AI: как пользоваться без интерфейса сайта?
Отправьте описание сцены в Videos API Relay. Ключ и доступ к видео относятся к Relay; инструкция не требует настройки кабинета на сайте Kling.
Почему после запроса нет ID задачи?
При HTTP 200 видео возвращается сразу как base64. ID нужен только для асинхронного ответа HTTP 202.
Можно ли начать с приветственного бонуса?
Видео недоступно до оплаченных пополнений на $10. Бонус в этот порог не входит.
Нужно ли создавать задачу заново после остановки скрипта?
Если ID сохранён, сначала проверьте существующую задачу. Остановка локального опроса не означает отмену генерации.