Перейти к основному содержанию
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-video-o1",
    "prompt": "Пусть персонаж на <<<image_1>>> машет рукой в камеру",
    "image_urls": ["https://example.com/portrait.jpg"],
    "mode": "std",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

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

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

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

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

​
model
string
обязательно
Название модели генерации видео, фиксированное значение kling-video-o1
​
prompt
string
обязательно
Текстовый промптПоддержка синтаксиса <<<image_N>>> для ссылки на изображения из image_urls, где N начинается с 1.Пример: "Пусть персонаж на <<<image_1>>> машет рукой в камеру"
Если переданы изображения, но в промпте нет ссылки <<<image_N>>>, система автоматически добавит <<<image_1>>> в начало промпта.
​
mode
string
по умолчанию:"std"
Режим генерацииВарианты:
  • std - Стандартный режим (720P)
  • pro - Профессиональный режим (1080P)
По умолчанию: std
​
duration
integer
по умолчанию:"5"
Длительность видео (секунды)Варианты: 5 или 10По умолчанию: 5
​
aspect_ratio
string
по умолчанию:"16:9"
Соотношение сторон видеоВарианты:
  • 16:9 - Альбомная ориентация (по умолчанию)
  • 9:16 - Портретная ориентация
  • 1:1 - Квадрат
По умолчанию: 16:9
​
image_urls
string[]
Массив URL изображений для ссылки в промптеВ промпте используйте <<<image_N>>> для ссылки на изображение по индексу (N с 1)Пример: ["https://example.com/photo.jpg"]
  • URL изображений должны быть публично доступны
  • При изображение-в-видео aspect_ratio может быть переопределён реальным соотношением сторон изображения
​
metadata
object
Специальные параметры расширения

​
Синтаксис ссылки на изображения

Модель Video O1 использует синтаксис <<<image_N>>> в промпте для ссылки на изображения:
СинтаксисОписание
<<<image_1>>>Ссылка на 1-е изображение в image_urls
<<<image_2>>>Ссылка на 2-е изображение в image_urls
Автоссылка: Если переданы image_urls, но в промпте нет <<<image_N>>>, система автоматически добавит <<<image_1>>> в начало промпта.

​
Ответ

​
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-video-o1",
  "prompt": "Городской горизонт в золотой час, кинематографическое качество",
  "mode": "pro",
  "duration": 5,
  "aspect_ratio": "16:9"
}

​
Сценарий 2: Ссылка на изображение (одно изображение)

{
  "model": "kling-video-o1",
  "prompt": "Пусть персонаж на <<<image_1>>> машет рукой в камеру",
  "image_urls": ["https://example.com/portrait.jpg"],
  "mode": "pro",
  "duration": 5
}

​
Сценарий 3: Несколько изображений

{
  "model": "kling-video-o1",
  "prompt": "Персонаж из <<<image_1>>> идёт к сцене из <<<image_2>>>",
  "image_urls": [
    "https://example.com/character.jpg",
    "https://example.com/scene.jpg"
  ],
  "mode": "pro",
  "duration": 5
}

​
Сценарий 4: Изображение без явной ссылки (автодобавление)

{
  "model": "kling-video-o1",
  "prompt": "Человек медленно поворачивается и улыбается",
  "image_urls": ["https://example.com/portrait.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-video-o1",
    "prompt": "Пусть персонаж на <<<image_1>>> машет рукой в камеру",
    "image_urls": ["https://example.com/portrait.jpg"],
    "mode": "std",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

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