Kuaishou
Kling 3.0
kling-3.0-omni/reference-to-video
Унифицированная серия для генерации мультимодального видео: текст в видео, изображение в видео, генерация видео по референсу и редактирование внутри видео, нативная синхронизация губ и многоязычное аудио
Попробовать kling-3.0-omni/reference-to-video
Ввод
Работы
Все работыВывод
videoЦены
kling-3.0-omni/reference-to-video per second
Краткое описание позиционирования
kling-3.0-omni/reference-to-video — это направление в серии Kling 3.0 Omni, ориентированное на генерацию видео по референсным изображениям. Оно позволяет использовать от 1 до 7 референсных изображений (или до 7 повторно используемых субъектных элементов) в качестве визуальных опор и вместе с текстовым запросом создавать видео длительностью от 3 до 15 секунд. Поддерживаются разрешения 720p, 1080p, 4k и соотношения сторон 16:9, 9:16, 1:1, можно включить нативный звук и интеллектуальную многокадровую съёмку. Подходит разработчикам, которым нужно сохранять единообразие персонажей или объектов между кадрами и массово выпускать маркетинговые видео и видео для соцсетей.
Ключевые особенности
- Двойная привязка: несколько референсных изображений и субъектные элементы — можно передать от 1 до 7 референсных изображений или определить до 7 субъектных элементов, каждый из 2–4 изображений, и ссылаться на них в запросе через @name.
- Необязательное добавление референсного видео — поддерживается добавление 1 референсного видео длительностью от 3 до 15,5 секунды для задания движения и композиции; в этом случае общий лимит референсных изображений и субъектов сокращается до 4.
- Разрешения и форматы от вертикали до 4K — на выбор 720p, 1080p, 4k; форматы 16:9, 9:16, 1:1 подходят как для горизонтальной раздачи, так и для вертикальных коротких видео.
- Комбинируемые нативный звук и многокадровость — по умолчанию отключённые нативный звук и интеллектуальная многокадровая съёмка могут быть включены одновременно, создавая за один раз многокадровый фрагмент со звуком; при использовании референсного видео они недоступны.
Описание возможностей
Генерация с согласованностью нескольких субъектов: через elements задаются имя субъекта, описание и 2–4 изображения одного и того же субъекта, а в запросе он вызывается через @name, чтобы один и тот же персонаж или объект сохранял внешний вид в нескольких кадрах.
Ограничение референсным видео: передаётся 1 референсное видео MP4/MOV (до 200 МБ, 3–15,5 секунды) для задания движения и ритма; подходит для стилизации или пересъёмки на основе уже имеющихся материалов.
Управление разрешением и форматом: выбирайте вывод 720p, 1080p или 4k в зависимости от канала размещения и задавайте формат 16:9, 9:16, 1:1, сокращая необходимость обрезки и перекодирования на постобработке.
Нативный звук и интеллектуальная многокадровость: при включении audio звук генерируется синхронно, а при включении prefer_multi_shots модель автоматически разбивает сцену на несколько кадров по запросу; обе функции доступны, когда референсное видео не используется.
Настраиваемая длительность и длина запроса: длительность вывода от 3 до 15 секунд задаётся по потребностям повествования, а запрос может содержать до 3072 символов — достаточно, чтобы описать субъект, действия и построение кадров.
Сценарии применения
- Команды бренд-маркетинга: референсные изображения + запрос с преимуществами товара — фиксируйте внешний вид по многогранным референсным изображениям товара и создавайте ролики с заданными форматом и разрешением для прямой раздачи в лентах и на сайте.
- Ведение соцсетей: элементы персонажа + вертикальный сценарий — определив фиксированные элементы персонажа, массово генерируйте короткие видео 9:16 с единым образом для ежедневного выпуска контента.
- Предпроизводство кино и анимации: референсное видео + раскадровка — задавайте ритм движения референсным видео и получайте многокадровые превизуализации, по которым режиссёр утверждает дизайн кадров и точки монтажа.
- Команды контента для электронной коммерции: галерея изображений товара в видео — загружайте референсные изображения товара и задавайте формат 1:1 или 16:9, создавая демонстрационные видео для страниц товара и главных изображений.
Ограничения и советы по выбору
Суммарно референсных изображений и субъектных элементов должно быть не более 7; при добавлении референсного видео лимит сокращается до 4, и тогда нативный звук и интеллектуальная многокадровая съёмка недоступны. Максимальная длительность за один раз — 15 секунд, длинные повествования нужно генерировать частями и затем склеивать. Референсные изображения должны быть в формате JPG/PNG, размер одного файла — не более 50 МБ, меньшая сторона — не менее 300 px; референсное видео — только MP4/MOV длительностью 3–15,5 секунды. Если требуется генерация по одному изображению или только по тексту, можно выбрать направления image-to-video или text-to-video той же серии; при особых требованиях к управлению движением стоит рассмотреть motion-control.
Новости
Смотреть changelog →- Новая модель Новая модель: Kling 3.0 Omni (可灵 O3), вызывается через POST /v1/tasks. kling-3.0-omn…
Частые вопросы
Все частые вопросы →-
Требуется ли загрузка изображения для Kling 3.0 Image-to-Video?
Да. В настоящее время kling-3.0/image-to-video — это маршрут генерации видео из изображения: входное изображение отвечает за субъект и начальную композицию, а Prompt — за движения, ракурс камеры и изменения окружения.
-
Какие длительности и разрешения поддерживает Kling 3.0 Image-to-Video?
Текущий контракт запросов HiAPI поддерживает 3–15s, выходное разрешение — 720p, 1080p, 4K. Допустимые значения определяются панелью параметров на странице и документацией API.
-
Как оплачивается Kling 3.0 Image-to-Video?
Задачи оплачиваются по длительности вывода и выбранному тарифному уровню. На странице отображается актуальная цена в соответствии с глобальной валютной единицей, а окончательное списание определяется записью успешно выполненных задач.
-
Как повысить стабильность主体 при генерации видео из изображения?
Используйте входное изображение с чётким主体, небольшим количеством перекрытий и полной композицией; в Prompt сначала опишите основное действие и движение камеры, а затем перечислите внешний вид, материалы и взаимосвязь с фоном, которые необходимо сохранить. Для первого теста рекомендуется использовать более короткую длительность.
Создать задачу генерации
https://api.hiapi.ai/v1/tasks Заголовки
AuthorizationstringОбязательноAPI-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ
Content-TypestringНеобязательноТело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.
Idempotency-KeystringНеобязательноКлюч идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.
При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.
Тело запроса
modelstringОбязательноТекущее фиксированное значение: kling-3.0-omni/reference-to-video
routestringНеобязательноТекущее фиксированное значение: default
inputobjectОбязательно
Объект бизнес-параметров для kling-3.0-omni/reference-to-video и маршрута default — см. таблицу параметров ниже.
audiobooleanНеобязательноПо умолчанию: falseСледует ли при генерации видео одновременно создавать нативную аудиодорожку, синхронизированную с изображением; булево значение, по умолчанию false; недоступно при передаче референсного видео (video_urls).
promptstringОбязательноminLength 1maxLength 3072Описание желаемого видеоконтента; если нужно использовать объект из elements, можно ссылаться на его имя в промпте в формате @name.
durationintegerНеобязательноПо умолчанию: 5min 3max 15Длительность выходного видео в секундах, целое число, диапазон от 3 до 15, по умолчанию 5.
elementsarrayНеобязательноmaxItems 7
Список переиспользуемых объектов, до 7 штук; каждый элемент содержит имя, краткое описание и 2-4 изображения, на него можно ссылаться в промпте в формате @name.
Array [ object ]
Элементы массива
namestringОбязательноminLength 1Уникальное имя объекта для ссылки в промпте в формате @name; имя не должно содержать пробелов.
descriptionstringОбязательноminLength 1Краткое описание объекта, помогающее модели распознать и воспроизвести его.
element_input_urlsarrayОбязательноminItems 2maxItems 4Массив референсных изображений одного объекта; требуется предоставить 2-4 изображения, поддерживаются форматы JPG/PNG.
Array [ string ]
image_urlsarrayОбязательноminItems 1maxItems 7Массив референсных изображений, можно предоставить 1-7 штук; при добавлении референсного видео — не более 4 штук, причём суммарно референсных изображений и объектов (elements) не более 7 (при наличии референсного видео — суммарно не более 4). Поддерживаются JPG/PNG, каждое не более 50MB, длина стороны не менее 300 px.
Array [ string ]
resolutionstringНеобязательноПо умолчанию: "720p"Разрешение выходного видео, строка, по умолчанию 720p.
720p1080p4kvideo_urlsarrayНеобязательноminItems 1maxItems 1Необязательный массив референсных видео, поддерживаются MP4 или MOV, каждое не более 200MB, длительность 3-15.5 секунд, ширина и высота 700-4553 px, частота кадров 24-60 fps; после добавления референсного видео нативная аудиодорожка и интеллектуальная многокадровость не поддерживаются.
Array [ string ]
aspect_ratiostringНеобязательноПо умолчанию: "16:9"Соотношение сторон выходного видео, строка, по умолчанию 16:9.
16:99:161:1prefer_multi_shotsbooleanНеобязательноПо умолчанию: falseСледует ли модели автоматически планировать несколько кадров на основе промпта; булево значение, по умолчанию false; недоступно после добавления референсного видео.
callbackobjectНеобязательно
Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.
Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.
urlstringОбязательноОбязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.
whenstringНеобязательноПо умолчанию: "final"Сейчас поддерживается только final — уведомление и при success, и при fail.
finalstoragestringНеобязательноПо умолчанию: "temp"Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.
temppersistentПримеры запроса
# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-3.0-omni/reference-to-video",
"input": {
"audio": false,
"prompt": "…",
"duration": 5,
"image_urls": "…",
"resolution": "720p",
"aspect_ratio": "16:9",
"prefer_multi_shots": false
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "kling-3.0-omni/reference-to-video",
input: {
"audio": false,
"prompt": "…",
"duration": 5,
"image_urls": "…",
"resolution": "720p",
"aspect_ratio": "16:9",
"prefer_multi_shots": false
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "kling-3.0-omni/reference-to-video",
"input": {
"audio": False,
"prompt": "…",
"duration": 5,
"image_urls": "…",
"resolution": "720p",
"aspect_ratio": "16:9",
"prefer_multi_shots": False
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Получить детали задачи
https://api.hiapi.ai/v1/tasks/:id Поля ответа
taskIdstringОбязательноИдентификатор задачи, всегда с префиксом tk-hiapi-.
modelstringОбязательноПолное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.
routestringНеобязательноПрисутствует только при явном параметре route; повторяет переданное значение.
statusstringОбязательноСтатус задачи.
queued В очереди, ещё не начата.
handling Обрабатывается.
archiving Обработка завершена, готовятся артефакты.
success Терминальное: завершено, артефакты доступны (возвращается output).
fail Терминальное: ошибка (возвращается error).
После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.
creatednumberОбязательноВремя создания задачи (Unix-секунды).
completednumberОбязательноUnix-секунды терминального состояния; до этого — 0.
outputarrayНеобязательно
Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).
Array [ object ]
Элементы массива
urlstringОбязательноURL артефакта, доступен для скачивания напрямую.
typestringОбязательноТекущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.
expireAtnumberОбязательноUnix-секунды доступности артефакта; скачайте или перенесите до истечения.
errorobjectНеобязательно
Только при status == fail.
codestringОбязательноБизнес-код ошибки.
messagestringОбязательноОписание ошибки.
Примеры ответа
Успех
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} Обработка (не финальное)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Ошибка
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Статьи
Все статьи →-
Руководство
Как вызвать hailuo-2.3-fast/image-to-video через HiAPI API: практика с curl и Python
Первый рабочий запрос к быстрому и недорогому уровню генерации видео по изображению — от ID модели до загрузки MP4
-
Руководство
Как вызывать hailuo-2.3/text-to-video через API HiAPI: curl, Python и рабочие примеры запросов
-
Руководство
Как вызывать kling-4.0/image-to-video на HiAPI: curl, Python и опрос
-
Руководство
Как использовать kling-4.0/text-to-video через HiAPI API: curl, Python и рабочий пример запроса
Практическое руководство для разработчиков: кинематографичные промпты, синхронный звук, асинхронный опрос и скачивание результатов
-
Руководство
kandinsky-6.0-pro/image-to-video в HiAPI: руководство по curl + Python
Как выполнить рабочий запрос генерации видео из изображения в HiAPI: от загрузки первого кадра до асинхронного опроса и финальной загрузки
-
Руководство
Использование Kandinsky 6.0 Pro для преобразования текста в видео на HiAPI: руководство по curl и Python
Практическая демонстрация с упором на запросы: построение вызова от промпта до видеоклипа, отправка запроса, опрос статуса завершения и скачивание результата
Похожие модели
Все модели →Тот же тип
-
Grok Imagine 1.5 Lite xAI $0.029 /секунду -
Creatify Boreal Creatify $0.015 /секунду -
Kling 3.0 Kuaishou $0.100 /секунду -
FLUX 3 Max Black Forest Labs $0.061 /секунду -
HeyGen Avatar IV HeyGen $0.150 /секунду -
Kling 4.0 Kuaishou $0.330 /секунду -
PixVerse V6 PixVerse $0.036 /секунду -
Kling 3.0 Turbo Kuaishou $0.130 /секунду -
HappyHorse 1.1 Alibaba $0.160 /секунду -
Wan 2.6 Flash Alibaba $0.043 /секунду -
HappyHorse 1.0 Alibaba $0.168 /секунду -
Veo 3.1 Lite Google $0.060 /секунду






