Kling V4 Flash — Параметры

Контракт APIMaster для kling-v4-flash, проверен 2026-11-07. Канал 317: текст, первый кадр, референсы, редактирование и продолжение. Только 720p, 24 кадра/с, 3–20 секунд; это отдельная модель от Kling V4.

Kling V4 Flash

Маршруты и авторизация

POST https://apimaster.ai/v1/videos
POST https://apimaster.ai/v1/videos/generations
GET https://apimaster.ai/v1/videos/{task_id}
GET https://apimaster.ai/v1/videos/{task_id}/content
GET https://apimaster.ai/v1/video-submissions/by-key

Параметры

JSON и Authorization: Bearer YOUR_API_KEY. model — kling-v4-flash. prompt обязателен, кроме генерации по одному начальному кадру. duration/seconds — целые JSON 3–20, по умолчанию 5; null означает отсутствие, 0 запрещён. Оба значения должны совпадать. При редактировании без duration берётся округлённая вверх длительность видеопотока. resolution — только 720p. aspect_ratio, также size: 16:9, 9:16, 1:1, 21:9; auto доступно только референсам. Текст по умолчанию 16:9, референсы auto, редактирование сохраняет исходные пропорции. Для первого кадра и продолжения непустые aspect_ratio/size запрещены. audio допускает только true, watermark — false.

Параметр	Тип JSON	Обязательность	По умолчанию	Назначение и ограничения
`model`	`string`	Да	`kling-v4-flash`	Всегда `kling-v4-flash`. Этот ID используется во всех пяти режимах; `kling-v4` — другая модель.
`prompt`	`string`	По режиму	—	Описание сцены, движения или изменений. Необязателен только для одного начального кадра. Ссылки `@Image1` и `@Video1` нумеруются отдельно с 1 по порядку массивов; редактируемое видео — `@Video1`.
`duration`	`integer / null`	Нет	`5`	Целое число JSON от 3 до 20, обычно 5 секунд. Без обоих полей длительности редактирование использует округлённую вверх длительность видеопотока; продолжение задаёт длину НОВОГО фрагмента. `null` означает отсутствие; 0, дроби и числовые строки недопустимы.
`seconds`	`integer / null`	Нет	—	Псевдоним `duration` с теми же правилами. Лучше передавать одно поле; при наличии обоих значения должны быть допустимыми и одинаковыми, иначе 400.
`resolution`	`string`	Нет	`720p`	Только `720p`. Это уровень качества, а не гарантия короткой стороны 720px. `1080p` и выбор качества через `mode` не поддерживаются.
`aspect_ratio`	`string`	Нет	По режиму	Текст/референсы/редактирование: `16:9`, `9:16`, `1:1`, `21:9`; `auto` только для референсов. По умолчанию: текст 16:9, референсы auto, редактирование как источник. Для начального кадра и продолжения непустое значение запрещено; пустая строка пропускается.
`size`	`string`	Нет	—	Псевдоним соотношения сторон `aspect_ratio`, не разрешение и не размер в пикселях. Оба поля должны совпадать. Для начального кадра и продолжения исключите оба.
`image_urls`	`string[]`	По режиму	—	Массив публичных URL изображений. Auto принимает один начальный кадр; для референсов только из изображений явно задайте `reference`. Референсы/редактирование: максимум 10 изображений вместе с ролью `reference_image`. Не смешивайте представления начального кадра; продолжение не принимает изображения.
`first_frame_image`	`string`	По режиму	—	Публичный URL единственного начального кадра. Альтернатива одному `image_urls` или роли `first_frame`, а не дополнительный кадр. Обе стороны изображения ≥300px, пропорции 2:5–5:2; при необходимости обрежьте заранее.
`image_with_roles`	`{url, role}[]`	По режиму	—	Каждый объект требует `url` и `role`. `first_frame` — единственный начальный кадр; `reference_image` — референс/редактирование. Последние/промежуточные/ключевые кадры запрещены. Всего ≤10 референсных изображений и ≤15 изображений/видео.
`video_url`	`string`	По режиму	—	Публичный URL одного источника только с явным `edit`/`extend`; несовместим с `video_urls`. Для редактирования: MP4/MOV, видеопоток 3–20с, каждая сторона 700–4553px. Продолжение начинается с последнего кадра и возвращает новый фрагмент. ID задачи/диалога не принимается.
`video_urls`	`string[]`	По режиму	—	До 5 референсных MP4/MOV; каждый видеопоток ≥3с, каждая сторона 700–4553px, сумма ≤20с. Явные edit/extend принимают ровно один элемент вместо `video_url`. Превышение отклоняется без обрезки; массив автоматически выбирает режим референсов.
`omni_reference_task_type`	`string`	Нет	`auto`	`auto` определяет текст/начальный кадр/референсы; `reference` требует референсные материалы; `edit`/`extend` требуют одно видео. Одиночный `video_url` без явного режима недопустим; два обычных изображения в auto не становятся референсами автоматически.
`audio_setting`	`string`	Нет	`auto`	Только референсы С ВИДЕО. `auto` создаёт звук заново; `origin` сохраняет звук ПЕРВОГО видео, при отсутствии дорожки результат тоже без дорожки. Для редактирования, продолжения, текста и референсов только из изображений поле исключите.
`audio`	`boolean`	Нет	`true`	Совместимый boolean: пропустите или передайте `true`; `false` запрещён. Сохранение исходного звука регулируется `audio_setting`, отдельные аудиореференсы не поддерживаются.
`watermark`	`boolean`	Нет	`false`	Совместимый boolean: пропустите или передайте `false`; `true` запрещён. Это не услуга удаления водяного знака с источника.

Только прямые публичные HTTP(S) URL без встроенных учётных данных, не base64/локальные пути/ID. Форматы и лимит байтов изображений отдельно не заявлены. Ограничение чтения 100MiB относится к каждому проверяемому видео reference/edit, а не ко всем загрузкам поставщика.

Режимы и материалы

Операция	Выбор режима и материалы	Значения по умолчанию и исключения
Текст → видео	Без материалов; prompt обязателен, тип auto или отсутствует.	5с, 16:9; без audio_setting.
Начальный кадр → видео	Один кадр в ОДНОМ представлении; prompt необязателен.	5с, пропорции изображения; без aspect_ratio/size и последнего кадра.
Референсы → видео	reference + изображения, роли reference_image или video_urls; prompt обязателен.	5с, auto; изображения≤10, видео≤5, всего≤15; звук настраивается только при наличии видео.
Редактирование	edit + одно видео; prompt обязателен, до 10 референсных изображений.	Длительность округляется вверх по источнику, пропорции источника; без кадровых ролей/audio_setting.
Продолжение	extend + одно видео; prompt обязателен.	5 НОВЫХ секунд; без изображений, переопределения пропорций/audio_setting; минимальные размеры и длительность edit/reference не применяются.

omni_reference_task_type: auto, reference, edit, extend. Один image_urls, first_frame_image или роль first_frame — начальный кадр. Несколько изображений требуют reference или ролей reference_image; два image_urls в auto отклоняются. video_urls без edit/extend означает референсы. video_url требует edit/extend и несовместим с video_urls. Для редактирования/продолжения нужен один ролик; при редактировании можно добавить изображения. Продолжение не принимает изображения/audio_setting и возвращает только новый фрагмент. Передавайте публичный URL исходного видео, а не ID задачи или разговора.

Прямые публичные HTTP(S) URL без встроенных паролей. До 10 изображений, суммарно до 15 изображений/видео. Изображения минимум 300×300, пропорции 2:5–5:2. До 5 MP4/MOV референсов: каждый минимум 3 секунды, вместе не более 20; для редактирования один ролик 3–20 секунд. И ширина, и высота 700–4553. Шлюз проверяет до 100 MiB каждого видео по видеопотоку, а не контейнеру/аудио. Эти проверки размеров/минимальной длины не относятся к входу продолжения. Геометрию изображений дополнительно проверяет поставщик. audio_setting=origin сохраняет звук первого видеореференса либо тишину, auto создаёт звук; только для референсов с видео. Редактирование создаёт звук заново. Нет аудио-URL, последнего/промежуточного кадра, ключевых кадров, negative_prompt, mode, seed, раскадровки и списков голосов/персонажей.

Размеры результата и частота кадров

Пропорции / режим	Пиксели по документации	Частота кадров
`16:9`	1280×720	24 fps
`9:16`	720×1280	24 fps
`1:1`	960×960	24 fps
`21:9`	1464×628	24 fps
Начальный кадр	По пропорциям изображения, около 0,92 Мп; например 604×1516 для 2:5.	24 fps

Размеры результата не являются требованиями к источнику. Высота 21:9 равна 628px: для референса/редактирования нужен источник ≥700px, для продолжения этот минимум не действует. Файл может быть длиннее запроса примерно на кадр.

Примеры без выполнения

1. `text`

{
  "model": "kling-v4-flash",
  "prompt": "A paper boat floats along a quiet stream.",
  "duration": 3,
  "aspect_ratio": "16:9"
}

2. `first_frame`

{
  "model": "kling-v4-flash",
  "image_urls": [
    "https://example.com/start.png"
  ],
  "duration": 3
}

3. `reference_image`

{
  "model": "kling-v4-flash",
  "prompt": "Animate the scene from @Image1.",
  "omni_reference_task_type": "reference",
  "image_urls": [
    "https://example.com/style.png"
  ],
  "duration": 3
}

4. `mixed_reference`

{
  "model": "kling-v4-flash",
  "prompt": "Animate @Image1 with the camera movement from @Video1.",
  "omni_reference_task_type": "reference",
  "image_with_roles": [
    {
      "url": "https://example.com/subject.png",
      "role": "reference_image"
    }
  ],
  "video_urls": [
    "https://example.com/camera.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "auto",
  "audio_setting": "origin"
}

5. `reference_video`

{
  "model": "kling-v4-flash",
  "prompt": "Follow the camera movement from @Video1.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "duration": 3,
  "aspect_ratio": "auto"
}

6. `reference_video / origin`

{
  "model": "kling-v4-flash",
  "prompt": "Follow @Video1 and preserve its original sound.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "audio_setting": "origin",
  "duration": 3
}

7. `edit / duration`

{
  "model": "kling-v4-flash",
  "prompt": "Change the light in @Video1 to sunset.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

8. `edit / default`

{
  "model": "kling-v4-flash",
  "prompt": "Change @Video1 to a snowy scene.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "image_with_roles": [
    {
      "url": "https://example.com/style.png",
      "role": "reference_image"
    }
  ]
}

9. `extend`

{
  "model": "kling-v4-flash",
  "prompt": "Continue the camera moving forward.",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

Расчёт стоимости

Номинальная официальная база: $0.094 за секунду выхода (720P), $0.0628 за расчётную секунду с видео (720P-input). Текст, изображения, референсы без видео и продолжение оплачивают выход/новый фрагмент. Видео-референсы и редактирование: выход + max(вход, выход). Сначала сложите длительности всех входных видеопотоков, затем округлите сумму вверх. Вход 3.04 с и выход 3 с: 3+max(4,3)=7 расчётных секунд. Лишний кадр в готовом файле не меняет заданную целую длину выхода. Скидки пакетов и множители аккаунта учитываются отдельно; итог смотрите в карточке и журнале. Подтверждённый сбой генерации возвращает резерв. Прекращение опроса не отменяет задачу. Неопределённый сетевой тайм-аут не разрешает новую генерацию.

input_seconds = ceil(sum(input_video_stream_seconds))
billable_seconds = output_seconds + max(input_seconds, output_seconds)

Опрос, ошибки и безопасный повтор

Первый приём: HTTP 200, публичный task_id, queued. GET /v1/videos/{task_id}: queued/in_progress/completed/failed, возможен временный unknown. url и metadata.url требуют Bearer; также GET /v1/videos/{task_id}/content. Сбой: error.code=generation_failed с очищенным сообщением; неверные параметры — HTTP 400. Idempotency-Key: 8–128 видимых ASCII без пробелов. Один аккаунт/ключ/запрос: повтор HTTP 202 без новой генерации/резерва; изменённый запрос — 409. GET /v1/video-submissions/by-key с прежним заголовком читает квитанцию. accepted+task_ready=true: опрашивайте task_id; pending/submitting или неготовая задача: ждите. acceptance_unknown: сохраните ключ и обратитесь в поддержку, не повторяйте автоматически. 404 не доказывает непринятие. Ключи хранятся минимум 30 дней. Это защита шлюза, не поиск у поставщика. Итоговая оплата — в журнале по other.task_id; опрос не гарантирует финальный счёт. /v1/videos/quote не поддерживается. Примеры не выполняются: замените URL; новый ключ для новой операции, прежний — только для её повтора.

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "queued",
  "created_at": 1794052800
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "completed",
  "progress": 100,
  "created_at": 1794052800,
  "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content",
  "metadata": {
    "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content"
  }
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "failed",
  "progress": 100,
  "created_at": 1794052800,
  "error": {
    "code": "generation_failed",
    "message": "Generation failed"
  }
}

APIMart · Kling V4 Flash · Kling AI

Kling V4 Flash

Маршруты и авторизация

Параметры

Режимы и материалы

Размеры результата и частота кадров

Примеры без выполнения

1. text

2. first_frame

3. reference_image

4. mixed_reference

5. reference_video

6. reference_video / origin

7. edit / duration

8. edit / default

9. extend