Kling 3.0 Omni

Kuaishou · ~5 мин

от $0.088за секунду

Универсальный Kling 3.0: по описанию, кадрам, до 7 фото-образцам или вашему видео — изменить ролик или взять его за образец. До 15 секунд, до 4K.

Kling 3.0 Omni — универсальная модель Kuaishou. Ролики от 3 до 15 секунд: по описанию, по первому и последнему кадру, по образцам (до 7 фото — в описании можно ссылаться «фото 1», «фото 2») или по вашему видео.

С видео (3–10 секунд, длиннее обрежется) два режима: «Изменить это видео» — результат той же длины, что ролик; «Взять за образец» — новый ролик выбранной длины в духе вашего (с ним можно одно фото — первый кадр). С видео доступны 720p и 1080p, звук не создаётся, но можно оставить звук ролика.

Качество: Standard (720p), Pro (1080p) или 4K. Звук без видео — по желанию, со звуком дороже. Цена — за каждую секунду ролика.

Одна модель kling-3.0-omni · ~5 мин. Что получится, задаётся полями input (описание, кадры, образцы, video_mode, длительность) — отдельных эндпоинтов «оживить / изменить» нет.

Возможности

generate_audio — звук в ролике

Цена

Разрешение	Без звука, за секунду	Со звуком, за секунду	С вашим видео, за секунду
720p	$0.088	$0.117	$0.132
1080p	$0.117	$0.146	$0.175
4k	$0.558	$0.558	—

Цена = цена секунды × длина ролика, округляется вверх до $0.001. Списывается при создании задачи и полностью возвращается, если задача не удалась.
С вашим видео (video_urls, один ролик 3–10 с): video_mode: "edit" — цена за секунды ролика, результат той же длины; video_mode: "reference" — за секунды нового ролика (duration). Ставка — «С вашим видео»; 4K с видео недоступно, звук не создаётся.
Фото-образцы в описании: <<<image_1>>>, <<<image_2>>>… Можно писать «фото 1», «photo 2» — заменим сами; без ссылок все фото подставятся в начало описания.
generate_audio по умолчанию false. В 4K со звуком и без — одна цена.

Лимиты медиа

Тип	Ограничения
Фото	до 7; JPG / PNG / WebP; загрузка через files/upload — до 30 МБ на файл
Видео	одно; 3…10 с (длиннее всегда обрезается до 10); на сервисе ≥ 720 px по короткой стороне — меньшие ролики увеличиваем сами; MP4 / MOV → MP4; загрузка ≤ 200 МБ

Фото — публичные https или upload; видео и звук — только через files/upload.

Параметры (поле `input`)

Параметр	Описание	Значения (по умолчанию — жирным)
`prompt`	Что происходит в ролике: сцена, движение, камера, свет, стиль	текст, до 2500 символов
`first_frame_url`	Первый кадр: ссылка на фото (https), с него начнётся видео	`"https://…"`
`last_frame_url`	Последний кадр (по желанию, только вместе с первым)	`"https://…"`
`image_urls`	Фото-образцы (https)	`["https://…"]`, до 7
`video_urls`	Одно ваше видео (MP4, 3–10 с; длиннее обрежется): сначала загрузите через files/upload. Только 720p / 1080p	`["https://…"]`, до 1
`video_mode`	Что сделать с вашим видео: `edit` (по умолчанию) — изменить его, длина результата как у ролика (3–10 с), до 4 фото; `reference` — новый ролик длины `duration` по образцу, можно одно фото (первый кадр)	`edit` · `reference`
`resolution`	Качество = режим Kling: `720p` — Standard (std), `1080p` — Pro (pro), `4k` — 4K. Можно передать и `mode`: `std` / `pro` / `4k`	`720p` · `1080p` · `4k`
`aspect_ratio`	Соотношение сторон	`16:9` · `9:16` · `1:1`
`duration`	Длительность ролика в секундах (при `video_mode: "edit"` не нужна — длина как у ролика)	от 3 до 15 (по умолчанию `5`)
`generate_audio`	Звук в ролике (шумы, музыка, голоса). По умолчанию `false`; со звуком дороже — см. цену. С `video_urls` не создаётся	`true` `false` (по умолчанию `false`)
`keep_original_sound`	Оставить звук вашего видео в результате	`true` `false` (по умолчанию `true`)

Примеры

Только описание

curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"kling-3.0-omni","input":{"prompt":"Дрон пролетает над осенним лесом на рассвете, туман, кинематографично","resolution":"720p","aspect_ratio":"16:9","duration":"5"}}'

import os, requests

r = requests.post(
    "https://mixmedia.tech/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "kling-3.0-omni",
      "input": {
        "prompt": "Дрон пролетает над осенним лесом на рассвете, туман, кинематографично",
        "resolution": "720p",
        "aspect_ratio": "16:9",
        "duration": "5"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}

const r = await fetch("https://mixmedia.tech/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "kling-3.0-omni",
    "input": {
      "prompt": "Дрон пролетает над осенним лесом на рассвете, туман, кинематографично",
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "duration": "5"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }

С первым кадром

curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"kling-3.0-omni","input":{"prompt":"Герой медленно поворачивается к камере, ветер развевает волосы","first_frame_url":"https://mixmedia.tech/static/img/previews/gpt-t2i.jpg","resolution":"720p","duration":"5"}}'

import os, requests

r = requests.post(
    "https://mixmedia.tech/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "kling-3.0-omni",
      "input": {
        "prompt": "Герой медленно поворачивается к камере, ветер развевает волосы",
        "first_frame_url": "https://mixmedia.tech/static/img/previews/gpt-t2i.jpg",
        "resolution": "720p",
        "duration": "5"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}

const r = await fetch("https://mixmedia.tech/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "kling-3.0-omni",
    "input": {
      "prompt": "Герой медленно поворачивается к камере, ветер развевает волосы",
      "first_frame_url": "https://mixmedia.tech/static/img/previews/gpt-t2i.jpg",
      "resolution": "720p",
      "duration": "5"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }

С образцами

curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"kling-3.0-omni","input":{"prompt":"Дрон пролетает над осенним лесом на рассвете, туман, кинематографично","image_urls":["https://mixmedia.tech/static/img/previews/gpt-t2i.jpg"],"resolution":"720p","aspect_ratio":"16:9","duration":"5"}}'

import os, requests

r = requests.post(
    "https://mixmedia.tech/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "kling-3.0-omni",
      "input": {
        "prompt": "Дрон пролетает над осенним лесом на рассвете, туман, кинематографично",
        "image_urls": [
          "https://mixmedia.tech/static/img/previews/gpt-t2i.jpg"
        ],
        "resolution": "720p",
        "aspect_ratio": "16:9",
        "duration": "5"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}

const r = await fetch("https://mixmedia.tech/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "kling-3.0-omni",
    "input": {
      "prompt": "Дрон пролетает над осенним лесом на рассвете, туман, кинематографично",
      "image_urls": [
        "https://mixmedia.tech/static/img/previews/gpt-t2i.jpg"
      ],
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "duration": "5"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }

С вашим видео

curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"kling-3.0-omni","input":{"prompt":"Сделай ролик в стиле аниме, остальное не меняй","video_urls":["https://mixmedia.tech/files/<id>.mp4"],"video_mode":"edit","resolution":"720p","duration":"5"}}'

import os, requests

r = requests.post(
    "https://mixmedia.tech/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "kling-3.0-omni",
      "input": {
        "prompt": "Сделай ролик в стиле аниме, остальное не меняй",
        "video_urls": [
          "https://mixmedia.tech/files/<id>.mp4"
        ],
        "video_mode": "edit",
        "resolution": "720p",
        "duration": "5"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}

const r = await fetch("https://mixmedia.tech/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "kling-3.0-omni",
    "input": {
      "prompt": "Сделай ролик в стиле аниме, остальное не меняй",
      "video_urls": [
        "https://mixmedia.tech/files/<id>.mp4"
      ],
      "video_mode": "edit",
      "resolution": "720p",
      "duration": "5"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }

Создание и результат

POST /api/v1/jobs/createTask с model и input.
Поллите GET /api/v1/jobs/recordInfo?taskId=… каждые 3–5 с (или callback).

Успешный createTask (HTTP 200)

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_...",
    "task_id": "task_...",
    "status": "submitted"
  }
}

Готовая задача (recordInfo)

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_...",
    "task_id": "task_...",
    "state": "success",
    "status": "completed",
    "costUsd": "0.384",
    "refunded": false,
    "resultJson": {
      "videos": [
        {
          "url": "https://…/out.mp4"
        }
      ],
      "duration": 8
    }
  }
}

Алиасы: task_id = taskId; status: pending / processing / completed / failed рядом с state. Ссылка на ролик — в resultJson. size — синоним aspect_ratio в input.

Фото можно передать любыми публичными https-ссылками или загрузить через files/upload. Видео и звук — только через files/upload.

Обработка ошибок

Ответ API — JSON {"code", "msg", "data"}; при ошибке есть строковое поле error (тип). На /api/v1/* HTTP-статус совпадает с code в теле.

Примеры тел ответа

400

{
  "code": 400,
  "msg": "input.duration: must be between 4 and 30, or \"auto\" / -1",
  "data": null,
  "error": "invalid_request_error"
}

401

{
  "code": 401,
  "msg": "Authentication failed. Please check your API key",
  "data": null,
  "error": "authentication_error"
}

402

{
  "code": 402,
  "msg": "Insufficient balance. Please top up and try again. Available: $0.01, required: $0.015. Top up at https://mixmedia.tech/cabinet/billing",
  "data": {
    "balance": "0.0100",
    "required": "0.0150",
    "currency": "USD",
    "topUpUrl": "https://mixmedia.tech/cabinet/billing"
  },
  "error": "payment_required"
}

429

{
  "code": 429,
  "msg": "Rate limit exceeded: 10 createTask/upload requests per 10 s per key. Retry after 8s",
  "data": null,
  "error": "rate_limit_error"
}

500

{
  "code": 500,
  "msg": "Internal server error",
  "data": null,
  "error": "server_error"
}

Коды при createTask / upload

code	error	Что значит	Что делать
400	`invalid_request_error`	Неверный параметр или тело	Смотрите `msg`
400	`unsupported_model`	Нет такой модели	Список моделей
400	`nsfw_content_detected`	Модерация / content policy — в `msg` / `failMsg` текст upstream как есть	Смотрите текст отказа, измените описание или файлы
401	`authentication_error`	Нет ключа или он неверный	Проверьте ключ
402	`payment_required`	Не хватает денег	Пополните баланс
403	`permission_error`	Нет доступа	Напишите в поддержку
429	`rate_limit_error`	Слишком много запросов	Подождите `Retry-After`
505	`model_disabled`	Модель временно отключена	Выберите другую
500	`server_error`	Сбой у нас	Повторите позже

Примеры msg: Authentication failed. Please check your API key (401); Insufficient balance. Please top up and try again… (402).

Ошибки задачи (recordInfo)

Если задача уже создана и завершилась неудачей: state: "fail" (алиас status: "failed"), failCode / failMsg, объект error: { code, message, type }. Деньги возвращаются (refunded: true).

failCode	error.type	Что значит
400	`nsfw_content_detected` / `invalid_request_error`	Модерация — `failMsg` = текст upstream как есть
422	`invalid_request_error`	Модель не приняла параметры (длина, режим, разрешение, файл)
501	`server_error`	Модель не смогла сгенерировать (`failMsg`)
504	`timeout_error`	Слишком долго — повторите
500 / 503	`server_error`	Сервис временно недоступен

Лимиты запросов

Что	Лимит
createTask и upload	20 за 10 с на ключ
recordInfo / list / balance	100 за 10 с на ключ

Сверх лимита — HTTP 429 и Retry-After.

#Возможности

#Цена

#Лимиты медиа

#Параметры (поле input)

#Примеры

#Только описание

#С первым кадром

#С образцами

#С вашим видео

#Создание и результат

#Успешный createTask (HTTP 200)

#Готовая задача (recordInfo)

#Обработка ошибок

#Примеры тел ответа

#Коды при createTask / upload

#Ошибки задачи (recordInfo)

#Лимиты запросов