kling-3.0-omni API

Используйте точный идентификатор модели kling-3.0-omni. Поле модели должно точно соответствовать этой странице.

Пример выводаkling-3.0-omniPOST /v1/videos5.0s

Параметры: duration=5resolution=1080pratio=16:9

Промпт: One continuous take, no cuts. A concrete rooftop at golden hour, the city low and hazy behind. A model in a chrome moulded dress stands still with arms down while loose fabric panels fly in from off frame, hundreds of them in coral, ultraviolet and bronze, and assemble around her into a vast sculpted train that keeps growing past the roof edge. The camera orbits her a full half turn at chest height and rises as the train forms. One hard low sun from the left, deep cool shadow on the right. Real weight and inertia, cloth snapping in the wind, no text.

Запрос, по которому был создан этот образец

{
  "model": "kling-3.0-omni",
  "prompt": "One continuous take, no cuts. A concrete rooftop at golden hour, the city low and hazy behind. A model in a chrome moulded dress stands still with arms down while loose fabric panels fly in from off frame, hundreds of them in coral, ultraviolet and bronze, and assemble around her into a vast sculpted train that keeps growing past the roof edge. The camera orbits her a full half turn at chest height and rises as the train forms. One hard low sun from the left, deep cool shadow on the right. Real weight and inertia, cloth snapping in the wind, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Аутентификация и конечная точка

Используйте ключ API Modelflare с https://modelflare.dev/v1. Точка входа шлюза — POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Создать задачу

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-3.0-omni",
    "prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot",
    "duration": "5", "mode": "std"
  }'

Опрос и загрузка

Сохраните идентификатор задачи. Опросите GET /v1/videos/{task_id} и загрузите с помощью GET /v1/videos/{task_id}/content. Срок действия URL-адресов результатов может истечь, поэтому передайте файл как можно скорее.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Запросить примечания

Kling использует специфичные для семейства поля model_name, prompt, mode, duration, image_list или contents/settings; Собственный JSON сохраняется и пересылается.

Запрос параметров

Kling Omni/O1 использует model_name, prompt и списки мультимедиа. Следуйте официальным ограничениям каждой модели при объединении image_list, video_list, element_list, multi_shot и sound.

Поле	Обязательно	Примечания
model_name	Да	kling-3.0-omni
prompt	Условно	Требуется, если режим серийной съемки отключен.
mode	Нет	std / pro
aspect_ratio	Условно	16:9 / 9:16 / 1:1
duration	Нет	3–15 секунд (строка)
image_list	Нет	Ссылки на первый/конечный кадр, сцену или стиль; Omni/O1 позволяет использовать несколько элементов в пределах модели.
video_list	Нет	Монтаж видео или ссылки на стили
element_list	Нет	Kling идентификаторы элементов; эта интеграция не обеспечивает управление элементами
multi_shot	Нет	Включить мультикадровую раскадровку
sound	Нет	Генерировать ли синхронизированный звук

Пределы ввода и вывода

Omni поддерживает разрешение 720p/1080p/4k, длительность 3–15 секунд, ссылки на изображения/видео/элементы и до шести кадров раскадровки. Отключите sound, если присутствует эталонное видео.

Документированные примеры рабочих процессов

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-3.0-omni",
    "prompt": "让图 1 中的人物在雨中向镜头挥手",
    "image_list": [{"image_url": "https://example.com/character.png"}],
    "duration": "5", "mode": "pro", "aspect_ratio": "16:9", "sound": "off"
  }'

Эталонные видео, элементы и комбинации нескольких кадров должны соответствовать ограничениям этой страницы; выключите sound при наличии эталонного видео.

Ошибки и невыполненные задачи

Неверные параметры модели возвращают 4xx с идентификатором запроса. Асинхронная задача также может оказаться неудачной после успешного создания; используйте error_code и error_message из ответа на опрос в качестве окончательной причины задачи. Не повторяйте тот же запрос с другой формой JSON.

Поддерживаемая область применения

На этой странице описаны вызовы создания и редактирования модели Modelflare. Поиск или расширение карты, голосовое управление и управление библиотекой элементов — это API-интерфейсы ресурсов, находящиеся за пределами этой общедоступной поверхности вызова модели, и они не являются обязательными полями запроса.

Цены и выставление счетов

В этой модели используется посекундная оплата видео. Текущую цену для клиентов, цену по справочному прейскуранту и полную спецификацию см. на странице цен модели .

Заметка

На этой странице документирован публичный интерфейс Modelflare; показанные здесь поля и ограничения соответствуют текущему контракту.