Перейти к основному содержанию
POST
/
v1
/
videos
/
generations
Генерация видео Kling v3 Omni
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "mode": "<string>",
  "duration": 123,
  "aspect_ratio": "<string>",
  "audio": true,
  "video_list": [
    {
      "video_url": "<string>",
      "refer_type": "<string>",
      "keep_original_sound": "<string>"
    }
  ],
  "metadata": {
    "image_list": [
      {
        "image_url": "<string>",
        "type": "<string>"
      }
    ],
    "element_list": [
      {
        "url": "<string>",
        "type": "<string>",
        "role": "<string>"
      }
    ],
    "watermark": true
  }
}
'
  • Асинхронный API, после отправки возвращает ID задачи
  • Использует официальные Omni-структуры ссылок: image_list, video_list и element_list
  • mode=std соответствует 720P, mode=pro соответствует 1080P
  • audio=true генерирует видео со звуком и тарифицируется как Sound
  • Запросы с video_list тарифицируются как Video
  • audio и video_list взаимоисключающие
Используйте публично доступные URL изображений и видео. Не передавайте base64-данные медиа напрямую. Для локальных изображений сначала используйте API загрузки изображений.

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

​
Authorization
string
обязательно
Все эндпоинты требуют Bearer Token.
Authorization: Bearer YOUR_API_KEY

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

​
model
string
обязательно
Название модели генерации видео, фиксированное значение kling-v3-omni.
​
prompt
string
обязательно
Текстовый промпт. Используйте официальные Omni-плейсхолдеры для ссылок на входные материалы:
  • <<<image_N>>> ссылается на metadata.image_list
  • <<<video_N>>> ссылается на video_list
  • <<<element_N>>> ссылается на metadata.element_list
Пример: "Пусть персонаж на <<<image_1>>> машет рукой в камеру"
Порядок списков должен совпадать с порядком соответствующих плейсхолдеров в prompt. Система не добавляет первый кадр и не вставляет плейсхолдеры автоматически.
​
mode
string
по умолчанию:"std"
Режим генерации: std для 720P или pro для 1080P.
​
duration
integer
по умолчанию:"5"
Длительность видео в секундах. Возможные значения: 5, 10.
​
aspect_ratio
string
по умолчанию:"16:9"
Соотношение сторон видео. Частые значения: 16:9, 9:16, 1:1.
​
audio
boolean
по умолчанию:"false"
Генерировать ли видео со звуком.
audio и video_list взаимоисключающие. Не передавайте audio=true, если указан video_list.
​
video_list
object[]
Официальный Omni-список референс-видео. В prompt используйте <<<video_1>>>, <<<video_2>>> и так далее.
​
metadata
object
Расширенные параметры.

​
Синтаксис Omni-ссылок

СинтаксисОписание
<<<image_1>>>Ссылка на первый элемент metadata.image_list
<<<video_1>>>Ссылка на первый элемент video_list
<<<element_1>>>Ссылка на первый элемент metadata.element_list
Порядок image_list, video_list и element_list должен совпадать с порядком соответствующих плейсхолдеров в prompt.

​
Примеры

​
Текст-в-видео

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

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

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

​
Первый и последний кадр

{
  "model": "kling-v3-omni",
  "prompt": "Переход от <<<image_1>>> к <<<image_2>>>",
  "mode": "pro",
  "duration": 5,
  "metadata": {
    "image_list": [
      {"image_url": "https://example.com/start.jpg", "type": "first_frame"},
      {"image_url": "https://example.com/end.jpg", "type": "end_frame"}
    ]
  }
}

​
Референс-видео

{
  "model": "kling-v3-omni",
  "prompt": "Заменить фон в <<<video_1>>> на закат у моря",
  "mode": "std",
  "video_list": [
    {
      "video_url": "https://example.com/source-video.mp4",
      "refer_type": "base",
      "keep_original_sound": "no"
    }
  ]
}

​
Субъект и референс движения

{
  "model": "kling-v3-omni",
  "prompt": "Пусть <<<element_1>>> повторяет движение из <<<video_1>>>",
  "mode": "pro",
  "video_list": [
    {
      "video_url": "https://example.com/motion-reference.mp4",
      "refer_type": "feature",
      "keep_original_sound": "no"
    }
  ],
  "metadata": {
    "element_list": [
      {"url": "https://example.com/character.jpg", "type": "image", "role": "subject"}
    ]
  }
}
Генерация видео асинхронная. Используйте статус видео задачи, чтобы получить прогресс и результат.