Що ви створите
Ви надішлете завдання Kling text-to-video, збережете повернутий ID завдання, опитуватимете відповідний endpoint завдання Kling і вирішите, коли додатиcallback_url для push-сповіщень.
Передумови
- Ключ API CometAPI, збережений у
COMETAPI_KEY - Python 3.10+ з
requestsабо Node.js 18+ - Серверний worker для опитування або HTTPS callback endpoint для webhook-ів
API key, базовий URL, автентифікація
Створіть завдання Kling text-to-video за допомогою:Приклади коду
Скористайтеся вкладками нижче для прикладів, які можна скопіювати, у cURL, Python і Node.js.Пояснення потоку
Генерація відео Kling є асинхронною. Endpoint створення повертаєdata.task_id. Опитуйте GET /kling/v1/videos/text2video/<task_id>, доки data.task_status не досягне succeed або failed. Коли завдання успішно завершиться, скопіюйте URL готового ресурсу з data.task_result у власне сховище, якщо вам потрібен довготривалий доступ.
Додайте callback_url, якщо хочете, щоб оновлення статусу завдання надсилалися на HTTPS endpoint, який ви контролюєте. Зберігайте опитування доступним для звірки стану та на випадок пропущеної доставки callback.
Загальні параметри
Усунення проблем / FAQ
Форма відповіді відрізняється від маршрутів відео OpenAI
Форма відповіді відрізняється від маршрутів відео OpenAI
Kling використовує специфічні для провайдера JSON-поля, такі як
data.task_id, data.task_status і data.task_result. Не обробляйте це так, як OpenAI-сумісні маршрути /v1/videos.Завдання ніколи не досягає succeed
Завдання ніколи не досягає succeed
Використовуйте обмежене опитування та перевіряйте
data.task_status_msg, коли завдання завершується з помилкою. Зберігайте ID завдання для подальшої діагностики.Що слід використовувати: callback_url чи polling
Що слід використовувати: callback_url чи polling
Використовуйте polling як базовий підхід. Додайте
callback_url для push-доставки, а потім звіряйте фінальний стан через polling.Наступні кроки
- Прочитайте довідник API Kling text-to-video.
- Використовуйте опитування через Отримати завдання Kling.
- Налаштуйте callback за допомогою Використання callback URL у Kling.
- Знайдіть моделі відео Kling у Models.
- Перегляньте Використання polling і webhook для генерації відео.
- Оцініть вартість завдання за допомогою Оцінка вартості запиту перед викликом моделі.