kling-3.0-turbo API

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

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

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

Промпт: A skateboarder launches a kickflip over a concrete stair set in a skate park at golden hour. Low-angle slow-motion tracking shot, the board spins under his feet, dust and sunlight flare, he lands and rolls past the camera. Realistic physics, cinematic sports film, no text.

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

{
  "model": "kling-3.0-turbo",
  "prompt": "A skateboarder launches a kickflip over a concrete stair set in a skate park at golden hour. Low-angle slow-motion tracking shot, the board spins under his feet, dust and sunlight flare, he lands and rolls past the camera. Realistic physics, cinematic sports film, 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": "kling-3.0-turbo",
    "prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot",
    "settings": {"duration": 5, "resolution": "720p"}
  }'

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

Сохраните идентификатор задачи. Опросите 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 3.0 Turbo выбирает модель в URL-пути; не помещайте model_name в тело. Для передачи текста в видео и изображения первого кадра в видео используются разные официальные пути.

Поле	Обязательно	Примечания
prompt	Да	Подсказка для преобразования текста в видео; используйте официальное ограничение длины
contents[]	Условно	Для преобразования изображения в видео включите prompt и first_frame.
settings.resolution	Нет	720p / 1080p
settings.aspect_ratio	Нет	16:9 / 9:16 / 1:1
settings.duration	Нет	3–15 секунд
options.watermark_info	Нет	Конфигурация водяных знаков

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

Для преобразования текста в видео и изображения первого кадра в видео используются prompt и contents[] соответственно. Вывод — 720p или 1080p в течение 3–15 секунд; Подсказки для нескольких кадров поддерживают до шести кадров.

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

Turbo использует обновленный конверт contents/settings/options. Идентификатор модели остается в поле model Modelflare, а вызовы поступают через /v1/videos.

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo",
    "contents": [{"type": "prompt", "text": "列车缓慢驶过雨夜城市"}],
    "settings": {"resolution": "1080p", "aspect_ratio": "16:9", "duration": 5},
    "options": {"watermark_info": {"enabled": false}}
  }'

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo",
    "contents": [{"type": "prompt", "text": "角色转身看向窗外"}, {"type": "first_frame", "url": "https://example.com/first.png"}],
    "settings": {"resolution": "1080p", "duration": 5}
  }'

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

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

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

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

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

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

Заметка

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