Перейти к основному содержанию
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kling-2-6",
    "prompt": "Золотой кот бежит по залитому солнцем лугу, замедленная съёмка",
    "mode": "std",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

{
  "id": "video_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ",
  "object": "generation.task",
  "model": "kling-2-6",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}
  • Асинхронный режим обработки, возвращает ID задачи для последующих запросов
  • Поддержка текст-в-видео, изображение-в-видео (первый кадр / первый-последний кадр)
  • Поддержка стандартного режима (720P) и профессионального режима (1080P)
  • Профессиональный режим поддерживает автоматическую генерацию аудио

​
Авторизация

​
Authorization
string
обязательно
Все конечные точки API требуют аутентификации с помощью Bearer TokenПолучите API Key: Посетите страницу управления API KeyДобавьте в заголовок запроса:
Authorization: Bearer YOUR_API_KEY

​
Параметры запроса

​
model
string
обязательно
Название модели генерации видео, фиксированное значение kling-2-6
​
prompt
string
обязательно
Текстовый промпт, максимум 2500 символовПодробно описывайте сцены, действия и стиль для лучших результатовПример: "Золотой кот бежит по залитому солнцем лугу, замедленная съёмка, кинематографическое качество"
​
mode
string
по умолчанию:"std"
Режим генерацииВарианты:
  • std - Стандартный режим (720P, только видео без звука)
  • pro - Профессиональный режим (1080P, поддержка автоматической генерации аудио)
По умолчанию: std
Ограничение стандартного режима: std поддерживает только видео без звука. Параметр audio требует режима pro.
​
duration
integer
по умолчанию:"5"
Длительность видео (секунды)Варианты: 5 или 10По умолчанию: 5
​
aspect_ratio
string
по умолчанию:"16:9"
Соотношение сторон видеоВарианты:
  • 16:9 - Альбомная ориентация (по умолчанию)
  • 9:16 - Портретная ориентация
  • 1:1 - Квадрат
По умолчанию: 16:9
​
negative_prompt
string
Негативный промпт для исключения нежелательного контентаПример: "размытый, низкое качество, искажённый"
​
image_urls
string[]
Массив URL изображений для генерации изображение-в-видео
  • 1 изображение: используется как первый кадр
  • 2 изображения: автоматически назначаются как первый + последний кадр (требуется mode: "pro")
Максимум 2 изображенияПример: ["https://example.com/first.jpg"]
  • Максимум 2 изображения
  • Последний кадр (2 изображения) требует только режима pro; std поддерживает только первый кадр (1 изображение)
  • Последний кадр и аудио взаимоисключающие: в режиме pro нельзя использовать одновременно последний кадр и аудио
  • В режиме изображение-в-видео aspect_ratio может быть переопределён реальным соотношением сторон изображения
​
audio
boolean
по умолчанию:"false"
Автоматически генерировать аудиоПо умолчанию: false
  • Доступно только в mode: "pro"
  • Взаимоисключающее с последним кадром: аудио нельзя использовать вместе с последним кадром (2 изображения)
​
watermark
boolean
Добавить водяной знак

​
Тарификация

Оплата посекундная, цена зависит от режима и настройки аудио:
РежимРазрешениеАудиоЦена
std720PНе поддерживается$0.0368 / сек
pro1080PВыкл$0.0625 / сек
pro1080PВкл$0.125 / сек
Пример: режим pro, 10-секундное видео без звука = 10 × 0.0625=0.0625 = 0.625

​
Матрица поддержки функций

ТипФункцияstd 5sstd 10spro 5spro 10s
Текст-в-видеоГенерация✅ (без звука)✅ (без звука)✅✅
Текст-в-видеоАвто аудио--✅✅
Изображение-в-видеоГенерация✅ (без звука)✅ (без звука)✅✅
Изображение-в-видеоПервый кадр✅✅✅✅
Изображение-в-видеоПоследний кадр--✅✅
Изображение-в-видеоАвто аудио--✅✅

​
Ответ

​
id
string
Уникальный идентификатор задачи для запроса статуса
​
object
string
Тип объекта, фиксированное значение generation.task
​
model
string
Название использованной модели
​
status
string
Статус задачи
  • queued - В очереди на обработку
  • in_progress - Обрабатывается
  • completed - Успешно завершено
  • failed - Ошибка
​
progress
integer
Процент выполнения задачи (0-100)
​
created_at
integer
Unix-временная метка создания задачи

​
Примеры использования

​
Сценарий 1: Текст-в-видео (стандартный режим)

{
  "model": "kling-2-6",
  "prompt": "Золотой кот бежит по залитому солнцем лугу, замедленная съёмка, кинематографическое качество",
  "mode": "std",
  "duration": 5,
  "aspect_ratio": "16:9"
}

​
Сценарий 2: Текст-в-видео (профессиональный режим + негативный промпт)

{
  "model": "kling-2-6",
  "prompt": "Перекрёсток Сибуя в Токио ночью, неоновые огни отражаются на мокрой земле, люди идут с зонтами",
  "negative_prompt": "размытый, низкое качество, искажённый",
  "mode": "pro",
  "duration": 10,
  "aspect_ratio": "16:9"
}

​
Сценарий 3: Изображение-в-видео (первый кадр)

{
  "model": "kling-2-6",
  "prompt": "Человек в кадре поворачивается и улыбается",
  "image_urls": ["https://example.com/portrait.jpg"],
  "mode": "std",
  "duration": 5
}

​
Сценарий 4: Профессиональный режим + авто аудио

{
  "model": "kling-2-6",
  "prompt": "Волны разбиваются о скалы, чайки кружат в небе, вдали маяк",
  "mode": "pro",
  "duration": 10,
  "audio": true,
  "aspect_ratio": "16:9"
}
Запрос результатов задачиГенерация видео является асинхронной задачей, после отправки возвращается ID задачи. Используйте конечную точку Получить статус задачи для запроса прогресса и результатов генерации.
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kling-2-6",
    "prompt": "Золотой кот бежит по залитому солнцем лугу, замедленная съёмка",
    "mode": "std",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

{
  "id": "video_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ",
  "object": "generation.task",
  "model": "kling-2-6",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}