Kling 4.0 Flash

Kling 4.0 Flash — облегчённая модель в семействе Kling 4.0 от Kuaishou. На SeedRouter она поддерживает генерацию видео из текста и по референсам: до 10 референсных изображений, до 5 видео-референсов и до 7 элементов (именованных объектов, созданных из 2–4 изображений или одного короткого видео), каждый из которых упоминается в промпте. Каждый ролик длится 3–20 секунд при разрешении 720p со звуком. Отправьте запрос, сохраните возвращённый ID задачи и получите готовое видео из задачи. Медиа передаются как URL.

ID моделей

Актуальные цены — на странице модели.

Краткий пример

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4-0-flash",
    "prompt": "A paper boat drifts down a rain-filled city gutter at dusk, the camera skimming the water beside it past glowing shop windows, raindrops ticking on the surface. No text, no logos.",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Конечная точка

POST https://api.seedrouter.ai/v1/videos/generations

Ответ — это задача ({"id": "task_...", "status": "processing"}), а не готовое видео. Опрашивайте GET /v1/tasks/{task_id} до получения результата. Храните API-ключи в коде на стороне сервера.

Параметры

Каждый ролик приходит со звуком; переключателя звука нет. Нет полей первого, промежуточного или последнего кадра, полей negative_prompt, watermark или отдельного поля voices: привяжите голос к элементу с помощью voice_url. Схема строгая: неизвестные поля отклоняются, а не игнорируются. callback_url недоступен; опрашивайте задачу вместо этого.

Упоминания

Ни один из отправляемых материалов не обязателен; без них запрос создаёт видео только из текста. Если вы отправляете материалы, ссылайтесь на них в промпте:

Каждый @, за которым следует буква, цифра, подчёркивание или китайский иероглиф, должен указывать на материал этого запроса, иначе запрос отклоняется до любого списания. Имена сопоставляются начиная с самых длинных и без учёта регистра. Если имя заканчивается буквой, цифрой или подчёркиванием, сразу за ним не может идти ещё один такой символ: @image_12 при одном изображении отклоняется; пишите @image_1 2 или @image_1,.

Видео-референсов и видеоэлементов вместе может быть не более 5, а изображений, видео и элементов вместе — не более 15.

{
  "model": "kling-4-0-flash",
  "prompt": "The dancer from @image_1 performs the routine of @video_1 on a rooftop at dusk",
  "image_urls": ["https://example.com/dancer.png"],
  "video_urls": ["https://example.com/routine.mp4"],
  "keep_original_sound": false,
  "duration": 8
}

Элементы

Элемент — это именованный объект, который можно повторно использовать в промпте. Есть два вида:

Имена состоят из 1–20 букв, цифр, подчёркиваний или китайских иероглифов и должны быть уникальными без учёта регистра. image_N, video_N, keyframe_N, object_N, audio_N, first_frame и last_frame зарезервированы.

{
  "model": "kling-4-0-flash",
  "prompt": "@Mira opens the shop door and greets the morning crowd",
  "elements": [
    {
      "name": "Mira",
      "image_urls": ["https://example.com/mira-front.png", "https://example.com/mira-side.png"],
      "tag": "character",
      "description": "baker in a flour-dusted apron"
    }
  ],
  "aspect_ratio": "9:16",
  "duration": 6
}

Входные медиа

Изображения, видео и аудио — это публичные URL HTTP(S). Base64 data URI не принимаются: загружайте файлы в свое хранилище и передавайте их URL. Общая длина видео-референсов и видеоэлементов должна составлять 2–20 секунд; их длина считывается при принятии запроса, а видео, длину которого не удалось прочитать, отклоняется до любого списания.

Измерения цены

Проверьте раздел цены модели для актуальных ставок. Kling 4.0 Flash оплачивается за секунду видео 720p:

text, reference images, image elements:   cost = duration × standard rate
reference videos or video elements:       cost = (output + max(output, input)) × video-input rate

input — суммарная длина видео-референсов и видеоэлементов, округлённая вверх до целых секунд. Она измеряется при принятии запроса, поэтому зарезервированная сумма совпадает со списываемой. Пример: ролик на 5 секунд с видео-референсом на 7,2 секунды оплачивается как 5 + 8 = 13 секунд; с видео-референсом на 3 секунды — как 5 + 5 = 10 секунд. Неудачные задачи не оплачиваются.

Схема выхода

Отправка возвращает задачу:

{"id": "task_...", "model": "kling-4-0-flash", "status": "processing", "created_at": 1789689600}

Получить задачу

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Опрашивайте каждые 10–20 секунд, пока status не станет completed или failed. Перерыв в сети при опросе не означает, что генерация не удалась: сохраняйте ID задачи и продолжайте её проверять. Не создавайте новую задачу для проверки прогресса.

Завершённая задача

{
  "id": "task_...",
  "model": "kling-4-0-flash",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689800,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

В наших тестах 5-секундные ролики возвращались как MP4 (H.264) с разрешением 1280 × 720 и стереодорожкой AAC через 91–103 секунды после отправки; файл длится примерно на один кадр дольше, чем duration (5,04 секунды вместо 5).

Ошибки

Запросы, отклоненные до создания задачи, возвращают ошибку HTTP с объектом error и не оплачиваются. Задача, которая не выполнена после принятия, возвращает HTTP 200 при запросе со статусом status: "failed" и объектом error.

Смотрите общий каталог ошибок для кодов, HTTP-статусов и указаний по повторным попыткам.

{
  "id": "task_...",
  "model": "kling-4-0-flash",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Если сама отправка истечёт по времени, проверьте ваши задачи перед повторной отправкой: первый запрос мог быть принят.

Советы

• Описывайте субъект, место, движение камеры, свет и звук; аудио ролика следует промпту.
• Используйте Flash, чтобы недорого пробовать промпты, соотношения сторон и референсы, затем переносите удачный кадр в Kling 4.0, когда нужны 1080p, ключевые кадры, редактирование или удлинение.
• Для повторяющегося персонажа создайте элемент с двумя или тремя чёткими ракурсами вместо одного референсного изображения.
• Добавляйте no text, no logos, чтобы избежать придуманных меток.

Связано

• Playground и цены Kling 4.0 Flash
• Справка API Kling 4.0
• Скачать OpenAPI
• Копируемый Markdown