Kling API на Python: запуск и получение видео

Пошаговое подключение Kling API на Python через NexusAPI: безопасный ключ, запуск асинхронной задачи, polling, обработка результата и ошибок.

Безопасная подготовка Python-проекта

Установите библиотеку requests и передайте ключ через переменную окружения NEXUS_API_KEY. Не записывайте токен в исходный код, публичный репозиторий, frontend bundle или журнал запросов. Серверный клиент добавляет заголовок Authorization: Bearer и Content-Type: application/json.

Запуск выполняется методом POST на https://nexusapi.dev/generate. Тело содержит объект params, model_name и параметры выбранной модели. Успешный асинхронный ответ имеет HTTP-код 202 и содержит task_id, но ещё не готовое видео.

Пример Kling API на Python

import os, time, requests
headers = {"Authorization": "Bearer " + os.environ["NEXUS_API_KEY"]}
created = requests.post("https://nexusapi.dev/generate", headers=headers, json={
  "params": {"model_name": "kling-v3", "prompt": "Cinematic night city", "duration": 5}
}, timeout=30)
created.raise_for_status()
task_id = created.json()["task_id"]
while True:
  task = requests.get(f"https://nexusapi.dev/tasks/{task_id}", headers=headers, timeout=30).json()
  if task["status"] in ("completed", "failed"):
    print(task)
    break
  time.sleep(5)

В production добавьте общий таймаут, ограниченное число повторов и журналирование task_id. Не запускайте плотный бесконечный polling: он не ускоряет генерацию. Для фоновых процессов можно передать webhook_url и оставить polling как резервный способ получения результата.