Генерация видео Kling v3 Omni

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "private_asset_review": true,
  "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
  }
}
'

import requests

url = "https://toapis.com/v1/videos/generations"

payload = {
    "model": "<string>",
    "private_asset_review": True,
    "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
    }
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    private_asset_review: true,
    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
    }
  })
};

fetch('https://toapis.com/v1/videos/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://toapis.com/v1/videos/generations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => '<string>',
    'private_asset_review' => true,
    '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
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://toapis.com/v1/videos/generations"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"private_asset_review\": true,\n  \"prompt\": \"<string>\",\n  \"mode\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"audio\": true,\n  \"video_list\": [\n    {\n      \"video_url\": \"<string>\",\n      \"refer_type\": \"<string>\",\n      \"keep_original_sound\": \"<string>\"\n    }\n  ],\n  \"metadata\": {\n    \"image_list\": [\n      {\n        \"image_url\": \"<string>\",\n        \"type\": \"<string>\"\n      }\n    ],\n    \"element_list\": [\n      {\n        \"url\": \"<string>\",\n        \"type\": \"<string>\",\n        \"role\": \"<string>\"\n      }\n    ],\n    \"watermark\": true\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://toapis.com/v1/videos/generations")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"private_asset_review\": true,\n  \"prompt\": \"<string>\",\n  \"mode\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"audio\": true,\n  \"video_list\": [\n    {\n      \"video_url\": \"<string>\",\n      \"refer_type\": \"<string>\",\n      \"keep_original_sound\": \"<string>\"\n    }\n  ],\n  \"metadata\": {\n    \"image_list\": [\n      {\n        \"image_url\": \"<string>\",\n        \"type\": \"<string>\"\n      }\n    ],\n    \"element_list\": [\n      {\n        \"url\": \"<string>\",\n        \"type\": \"<string>\",\n        \"role\": \"<string>\"\n      }\n    ],\n    \"watermark\": true\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://toapis.com/v1/videos/generations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"private_asset_review\": true,\n  \"prompt\": \"<string>\",\n  \"mode\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"audio\": true,\n  \"video_list\": [\n    {\n      \"video_url\": \"<string>\",\n      \"refer_type\": \"<string>\",\n      \"keep_original_sound\": \"<string>\"\n    }\n  ],\n  \"metadata\": {\n    \"image_list\": [\n      {\n        \"image_url\": \"<string>\",\n        \"type\": \"<string>\"\n      }\n    ],\n    \"element_list\": [\n      {\n        \"url\": \"<string>\",\n        \"type\": \"<string>\",\n        \"role\": \"<string>\"\n      }\n    ],\n    \"watermark\": true\n  }\n}"

response = http.request(request)
puts response.read_body

POST

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>",
  "private_asset_review": true,
  "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
  }
}
'

import requests

url = "https://toapis.com/v1/videos/generations"

payload = {
    "model": "<string>",
    "private_asset_review": True,
    "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
    }
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    private_asset_review: true,
    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
    }
  })
};

fetch('https://toapis.com/v1/videos/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://toapis.com/v1/videos/generations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => '<string>',
    'private_asset_review' => true,
    '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
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://toapis.com/v1/videos/generations"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"private_asset_review\": true,\n  \"prompt\": \"<string>\",\n  \"mode\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"audio\": true,\n  \"video_list\": [\n    {\n      \"video_url\": \"<string>\",\n      \"refer_type\": \"<string>\",\n      \"keep_original_sound\": \"<string>\"\n    }\n  ],\n  \"metadata\": {\n    \"image_list\": [\n      {\n        \"image_url\": \"<string>\",\n        \"type\": \"<string>\"\n      }\n    ],\n    \"element_list\": [\n      {\n        \"url\": \"<string>\",\n        \"type\": \"<string>\",\n        \"role\": \"<string>\"\n      }\n    ],\n    \"watermark\": true\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://toapis.com/v1/videos/generations")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"private_asset_review\": true,\n  \"prompt\": \"<string>\",\n  \"mode\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"audio\": true,\n  \"video_list\": [\n    {\n      \"video_url\": \"<string>\",\n      \"refer_type\": \"<string>\",\n      \"keep_original_sound\": \"<string>\"\n    }\n  ],\n  \"metadata\": {\n    \"image_list\": [\n      {\n        \"image_url\": \"<string>\",\n        \"type\": \"<string>\"\n      }\n    ],\n    \"element_list\": [\n      {\n        \"url\": \"<string>\",\n        \"type\": \"<string>\",\n        \"role\": \"<string>\"\n      }\n    ],\n    \"watermark\": true\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://toapis.com/v1/videos/generations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"private_asset_review\": true,\n  \"prompt\": \"<string>\",\n  \"mode\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"audio\": true,\n  \"video_list\": [\n    {\n      \"video_url\": \"<string>\",\n      \"refer_type\": \"<string>\",\n      \"keep_original_sound\": \"<string>\"\n    }\n  ],\n  \"metadata\": {\n    \"image_list\": [\n      {\n        \"image_url\": \"<string>\",\n        \"type\": \"<string>\"\n      }\n    ],\n    \"element_list\": [\n      {\n        \"url\": \"<string>\",\n        \"type\": \"<string>\",\n        \"role\": \"<string>\"\n      }\n    ],\n    \"watermark\": true\n  }\n}"

response = http.request(request)
puts response.read_body

Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.

Асинхронный 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 загрузки изображений.

Авторизация

string

обязательно

Все эндпоинты требуют Bearer Token.

Authorization: Bearer YOUR_API_KEY

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

string

обязательно

Название модели генерации видео, фиксированное значение kling-v3-omni.

boolean

по умолчанию:false

Можно использовать в запросах с video_list. При true действуют обычные правила маршрутизации; каналы без приватной библиотеки пропускают проверку и сохраняют прежнюю обработку. video_list не отправляется на проверку приватных материалов, ограничения входного видео и тарифы не меняются. Новый режим отклоняет asset://. Если материалы указаны только в metadata, не передавайте переключатель или задайте false. См. проверку материалов по запросу.

string

обязательно

Текстовый промпт. Используйте официальные Omni-плейсхолдеры для ссылок на входные материалы:

<<<image_N>>> ссылается на metadata.image_list
<<<video_N>>> ссылается на video_list
<<<element_N>>> ссылается на metadata.element_list

Пример: "Пусть персонаж на <<<image_1>>> машет рукой в камеру"

Порядок списков должен совпадать с порядком соответствующих плейсхолдеров в prompt. Система не добавляет первый кадр и не вставляет плейсхолдеры автоматически.

string

по умолчанию:"std"

Режим генерации: std для 720P или pro для 1080P.

integer

по умолчанию:"5"

Длительность видео в секундах. Возможные значения: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.

string

по умолчанию:"16:9"

Соотношение сторон видео. Частые значения: 16:9, 9:16, 1:1.

boolean

по умолчанию:"false"

Генерировать ли видео со звуком.

audio и video_list взаимоисключающие. Не передавайте audio=true, если указан video_list.

Официальный Omni-список референс-видео. В prompt используйте <<<video_1>>>, <<<video_2>>> и так далее.

Показать Поля объекта video_list

string

обязательно

URL референс-видео, публично доступный.

string

по умолчанию:"base"

Тип референса: base для редактируемого исходного видео или feature для референса движения/особенностей.

string

по умолчанию:"no"

Сохранять ли оригинальный звук видео: yes или no.

object

Расширенные параметры.

Показать Поля metadata

object[]

Официальный Omni-список изображений. В prompt используйте <<<image_1>>>, <<<image_2>>> и так далее.

Показать Поля объекта image_list

string

обязательно

URL изображения, публично доступный.

string

Тип изображения. Для первого/последнего кадра используйте first_frame или end_frame. Если указан end_frame, также требуется first_frame.

object[]

Официальный Omni-список субъектов/ролей. В prompt используйте <<<element_1>>>, <<<element_2>>> и так далее.

Показать Поля объекта element_list

string

обязательно

URL изображения субъекта, ассета персонажа или другого поддерживаемого материала.

string

Тип элемента, например image или video.

string

Ролевая семантика, поддерживаемая официальной моделью.

boolean

Добавить водяной знак.

Синтаксис 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"}
    ]
  }
}

Генерация видео асинхронная. Используйте статус видео задачи, чтобы получить прогресс и результат.

Обзор

Быстрый старт

API чата

API изображений

API видео

Управление задачами

Загрузка файлов

Аккаунт

Часто задаваемые вопросы

Генерация видео Kling v3 Omni

Авторизация

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

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

Примеры

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

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

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

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

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

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

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

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

​Примеры

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

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

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

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

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

Авторизация

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

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

Примеры

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

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

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

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

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