Перейти к основному содержанию
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-v3",
    "prompt": "Золотой кот бежит по залитому солнцем лугу, замедленная съёмка",
    "mode": "std",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

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

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

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

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

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

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

ТипФункцияstd 5sstd 10sstd 15spro 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-временная метка создания задачи
​
metadata
object
Метаданные задачи

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

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

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

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

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

​
Сценарий 3: Текст-в-видео (15 секунд)

{
  "model": "kling-v3",
  "prompt": "Цветок в саду расцветает в замедленной съёмке",
  "duration": 15,
  "aspect_ratio": "16:9"
}

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

{
  "model": "kling-v3",
  "prompt": "Кот медленно идёт вперёд, оглядывается",
  "image_urls": ["https://example.com/cat.jpg"],
  "mode": "std",
  "duration": 5
}

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

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

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