В документации OdiRouter API Kling описывается асинхронный поток для kling-v3-t2v. Ваше приложение создаёт задачу, сохраняет возвращённый идентификатор запроса, проверяет статус, а затем запрашивает результат. Этот шаблон подходит для работы с видео, которая не завершается за один обычный цикл запроса и ответа.
Эта страница основана на публичной Kling V3 text-to-video documentation. Проверьте её перед выпуском в производственную среду. Варианты моделей и цены могут меняться.
Начните с документированных URL и заголовка авторизации
Базовый URL-адрес API документированной модели: https://api.odirouter.ai/model. Для каждого запроса требуется Authorization: Bearer YOUR_API_KEY. Храните ключ в секретном ключе на стороне сервера или в переменной окружения. Сборка для браузера и публичный репозиторий — неподходящие места для настоящего API-ключа.
Маршрут создания задач модели:
POST /v1/queue/kling-v3-t2vВ этом запросе используются конечная точка и поля, указанные в справочнике OdiRouter:
export ODIROUTER_API_KEY="YOUR_API_KEY"
curl --request POST "https://api.odirouter.ai/model/v1/queue/kling-v3-t2v" \
--header "Authorization: Bearer $ODIROUTER_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"prompt": "A cinematic drone shot over a misty mountain range at sunrise",
"negative_prompt": "blurry, low quality, distorted",
"sound": "on",
"cfg_scale": 0.5,
"mode": "std",
"aspect_ratio": "16:9",
"duration": "5"
}'Пример включает текстовый промпт, негативный промпт, управление звуком, cfg_scale, режим, соотношение сторон и длительность. Передайте запросы через правила проверки, необходимые для вашего продукта.
Сохраните URL-адреса задач из ответа на создание
Документированный ответ содержит request_id, status_url, response_url, cancel_url и queue_position. Сохраните идентификатор и URL-адреса вместе с записью о задании. Они предоставляют вашему приложению прямой способ отслеживать задачу.
{
"request_id": "task_01hxyz...",
"status_url": "https://api.odirouter.ai/model/v1/queue/kling-v3-t2v/requests/task_01hxyz.../status",
"response_url": "https://api.odirouter.ai/model/v1/queue/kling-v3-t2v/requests/task_01hxyz.../response",
"cancel_url": "https://api.odirouter.ai/model/v1/queue/kling-v3-t2v/requests/task_01hxyz.../cancel",
"queue_position": 0
}Проверяйте, получайте или отменяйте задачу
OdiRouter документирует следующие маршруты для kling-v3-t2v:
GET /v1/queue/kling-v3-t2v/requests/{request_id}/status
GET /v1/queue/kling-v3-t2v/requests/{request_id}/response
PUT /v1/queue/kling-v3-t2v/requests/{request_id}/cancelИспользуйте маршрут статуса, пока задача ожидает выполнения. После завершения запросите маршрут ответа. Используйте опцию отмены, если вашему приложению необходимо остановить задачу, находящуюся в очереди или выполняющуюся в данный момент. Вашему приложению по-прежнему необходима собственная логика повторных попыток, тайм-аутов и уведомлений пользователей в дополнение к ответу API.
Выберите указанные в документации элементы управления Kling V3.
В справочнике перечислены std, pro и 4k. В нём std описывается как 720P, pro — как 1080P, а 4k — как 4K. Документированные соотношения сторон: 16:9, 9:16 и 1:1. Перечисленные варианты длительности составляют от 3 до 15 секунд.
Используйте каталог видеомоделей для сравнения доступных вариантов видео. Перед выпуском ознакомьтесь с pricing page, если стоимость влияет на архитектуру вашего решения. Публичные страницы OdiRouter являются источником актуальной информации о доступности, а не более ранняя заметка об интеграции.
Продолжите с OdiRouter
Начните с OdiRouter introduction, затем ознакомьтесь с Kling V3 text-to-video API reference. Каталог видеомоделей и pricing page предоставляют актуальный контекст о моделях и ценах.