Kandinsky 6.0 Pro

kandinsky-6.0-pro/text-to-video

Открытая диффузионная видеомодель, генерирующая примерно 5-секундные видео с синхронизированным аудио 44 кГц и синхронизацией губ, поддерживающая генерацию видео из текста/изображения с возможностью апскейла до Full-HD

kandinsky-6.0-pro/image-to-video kandinsky-6.0-pro/text-to-video

Попробовать kandinsky-6.0-pro/text-to-video

Ввод

Вывод

Заполните параметры и сгенерируйте — результаты появятся здесь.

Цены

kandinsky-6.0-pro/text-to-video per video

Цена за единицу	$1.9286

Описание позиционирования

Модель генерации видео из текста Kandinsky 6.0 Pro предназначена для разработчиков, которым нужно за один проход получить видео со звуком. Единственный обязательный вход — текстовый промпт: модель одновременно с изображением создаёт синхронизированный аудиотрек, выдаёт фрагмент длительностью около 5 секунд, поддерживает различные пропорции кадра — горизонтальную, вертикальную и квадратную, — а также позволяет задать случайное зерно для воспроизводимости результата. Подходит для прототипирования материалов для коротких видео, проверки кадров с озвучкой и синхронизацией движения губ, а также для команд, которые быстро итерируют идеи с помощью англоязычных или русскоязычных промптов.

Ключевые особенности

Изображение и аудио за одну генерацию — промпт может одновременно описывать субъект, действие, камеру и звук; изображение и аудио создаются в одном конвейере, что избавляет от последующей подгонки озвучки.
Воспроизводимое управление генерацией — предусмотрен параметр seed: зафиксировав его, удобно сравнивать версии одного и того же промпта и проводить регрессионные проверки.
Поддержка нескольких пропорций кадра — доступны пять форматов вывода: 16:9, 9:16, 1:1, 4:3, 3:4; можно напрямую переключаться между горизонтальными, вертикальными и квадратными роликами.
Раздельное управление промптом и негативными ограничениями — guidance_scale регулирует степень следования промпту, а negative_prompt отдельно задаёт то, чего следует избегать.

Описание возможностей

Генерация видео со звуком по промпту: достаточно ввести промпт с описанием изображения и звука, чтобы получить короткий фрагмент с синхронизированным аудио; модель нативно поддерживает англоязычные и русскоязычные промпты, что позволяет управлять содержанием и атмосферой ролика на естественном языке.

Переключение пропорций кадра: параметр aspect_ratio позволяет выбирать между горизонтальным, вертикальным и квадратным форматом; один и тот же промпт быстро выдаёт версии для разных площадок размещения.

Степень следования и негативные ограничения: guidance_scale в диапазоне от 1 до 10 регулирует строгость воспроизведения текста, а negative_prompt служит для исключения нежелательных элементов; совместное использование сужает пространство проб и ошибок.

Воспроизводимость по seed: seed позволяет зафиксировать случайность, а при передаче пустого значения результат генерируется случайно; подходит для фиксации результата на этапе утверждения или для контрольных экспериментов при подборе параметров.

Сценарии применения

Быстрое создание материалов для коротких видео в соцсетях — маркетологи или проверяющие сценарии пользователи вводят промпт с описанием изображения и звуковых эффектов и сразу получают ролик длительностью около 5 секунд для прототипа вертикального или квадратного материала размещения.
Проверка концепции кадра с озвучкой — креативные команды описывают в промпте действия персонажа и звук, генерируют короткий кадр с аудио и демонстрируют заказчику или команде ритм повествования и атмосферу.
Пакетная адаптация под несколько форматов — разработчикам, которым нужно охватить одной идеей горизонтальные и вертикальные каналы, достаточно зафиксировать seed и промпт и переключать пропорцию кадра, получая несколько версий материала без повторной настройки.

Ограничения и рекомендации по выбору

За одну генерацию выдаётся короткий фрагмент длительностью около 5 секунд; для повествовательного длинного видео потребуется самостоятельно генерировать сегменты и затем склеивать их. Генерация со звуком означает, что промпт должен одновременно учитывать описание изображения и звука; при сложной композиции может потребоваться несколько раундов настройки guidance_scale и негативного промпта для сходимости. Сейчас поддерживается только текстовый ввод; если уже есть статичный материал, который должен задавать динамику, следует использовать ветку генерации видео из изображения той же серии. В сценариях с более высокими требованиями к длительности и разрешению ролика нужно оценить необходимость последующей обработки, например апскейлинга.

Создать задачу генерации

POST 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Обязательно

Текущее фиксированное значение: kandinsky-6.0-pro/text-to-video

routestringНеобязательно

Текущее фиксированное значение: default

inputobjectОбязательно

Объект бизнес-параметров для kandinsky-6.0-pro/text-to-video и маршрута default — см. таблицу параметров ниже.

seedintegerНеобязательно

Random seed for reproducing a generation. Omit for a random seed.

promptstringОбязательноminLength 1maxLength 6000

Describe the video and the sound you want. Write subject, action, camera and audio in one or two sentences. English and Russian prompts are supported natively.

aspect_ratiostringНеобязательноПо умолчанию: "16:9"

Output frame. 16:9 and 4:3 are landscape, 9:16 and 3:4 vertical, 1:1 square.

Варианты:16:99:161:14:33:4

guidance_scalenumberНеобязательноПо умолчанию: 5min 1max 10

How closely the result follows the prompt. Higher values follow the text more strictly.

negative_promptstringНеобязательноmaxLength 2000

What to avoid in the video. Leave empty to use the built-in negative prompt.

callbackobjectНеобязательно

Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.

Обратные вызовы (Webhook)

Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.

urlstringОбязательно

Обязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.

whenstringНеобязательноПо умолчанию: "final"

Сейчас поддерживается только final — уведомление и при success, и при fail.

Варианты:final

storagestringНеобязательноПо умолчанию: "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": "kandinsky-6.0-pro/text-to-video",
  "input": {
    "prompt": "…",
    "aspect_ratio": "16:9",
    "guidance_scale": 5
  }
}'

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: "kandinsky-6.0-pro/text-to-video",
    input: {
      "prompt": "…",
      "aspect_ratio": "16:9",
      "guidance_scale": 5
    }
  }),
});
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": "kandinsky-6.0-pro/text-to-video",
        "input": {
          "prompt": "…",
          "aspect_ratio": "16:9",
          "guidance_scale": 5
        }
    },
)
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"
}

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

GET 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"
    }
  }
}