Генерация видео · luma

Luma Ray 2

luma-dream-machine

Luma Ray 2 — генерация видео от Luma AI, доступная через единый Ranvik API. Поддерживаемые возможности: image_to_video, text_to_video.

от 112 ₽ / сек

Карточка модели

Технические характеристики

МодальностьГенерация видео

Провайдерluma

СтатусАктивна

ID для запросовluma-dream-machine

Возможности

Image-to-video
Text-to-video

Цены

Единица	Цена
за секунду · Ray 2	112 ₽

Цены указаны в рублях. Списываются с баланса проекта при каждом успешном запросе.

Поддерживаемые параметры

Параметры передаются вендору как есть (pure proxy) — мы не валидируем их у себя на стороне. Если вендор не примет — вернётся его ошибка.

Параметр Тип Диапазон / values Default Описание

promptrequired

string

—

Текстовое описание желаемого видео. Camera motions добавлять прямо в prompt (например "camera orbit left").

примеры значений

Примеры

A tiger walking in snow, slow motion, cinematic lighting.

resolution enum 540p, 720p, 1080p, 4k 720p Разрешение видео. 4k — самое дорогое.

duration enum 5s, 9s 5s Длительность видео. Передаётся как строка с суффиксом s.

aspect_ratio enum 1:1, 16:9, 9:16, 4:3, 3:4, 21:9 16:9 Соотношение сторон видео.

loop boolean — false Зацикленное видео (loop). Финальный кадр плавно переходит в первый.

keyframes

object

—

Ключевые кадры для image-to-video, extend и interpolate режимов. frame0 — стартовый, frame1 — финальный. Каждый — либо image (url), либо generation (id предыдущего видео).

1 формата ввода

Keyframes object {frame0, frame1}

Поле	Тип	Значения	Описание
`frame0`	object	—	Стартовый кадр: {type: "image", url} или {type: "generation", id}.
`frame1`	object	—	Финальный кадр: {type: "image", url} или {type: "generation", id}.

{
  "frame0": {
    "type": "image",
    "url": "https://example.com/start.jpg"
  },
  "frame1": {
    "type": "image",
    "url": "https://example.com/end.jpg"
  }
}

concepts

array of objects

—

Preset-эффекты камеры / движения. Полный список через GET /v1/generations/concepts/list. Каждый item — объект {key: "concept_name"}.

1 формата ввода

Concept entries

Поле	Тип	Значения	Описание
`key`req	string	—	Идентификатор концепта (например "dolly_zoom"). Полный список: GET /v1/generations/concepts/list.

[
  {
    "key": "dolly_zoom"
  }
]

callback_url

string

—

URL для POST-уведомлений при изменении статуса (dreaming / completed / failed). Может вызываться несколько раз. Ожидается 200; иначе ретрай 3 раза с задержкой 100ms, timeout 5s.

примеры значений

Примеры

https://yourapp.com/webhooks/luma

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

Что возвращает API. У медиа-моделей формат зависит от режима: sync — сразу результат, async — task_id для опроса через GET /v1/tasks/{id}. Эта модель работает только в async-режиме.

Async (HTTP 202)

HTTP 202. Видео-генерация всегда async — нет sync-режима.

Поле	Тип	Значения	Описание
`id`	string	—	task_id для GET /v1/tasks/{id}.
`object`	string	video.task
`status`	enum	queued, processing, completed, failed
`model`	string	—
`created`	integer	—

Опрос статуса (GET /v1/tasks/{id})

GET /v1/tasks/{id} — опрос статуса.

Поле	Тип	Значения	Описание
`id`	string	—
`status`	enum	queued, processing, completed, failed, canceled
`modality`	string	video
`model`	string	—
`data`	array	—	Каждый элемент: `url`— string · CDN URL .mp4 / .webm / .mov.
`error`	string	—

Пример запроса

from openai import OpenAI

client = OpenAI(api_key="rk_live_...", base_url="https://api.ranvik.ru/v1")
resp = client.videos.generate(
    model= "luma-dream-machine",
    prompt= "Пример промпта",
    resolution= "720p",
    duration= "5s",
    aspect_ratio= "16:9",
    loop= False,
    keyframes= {},
    concepts= [],
    callback_url= "https://example.com/...",
)
print(resp)

Замените rk_live_... на ваш ключ из кабинета.

О провайдере: Luma AI

Luma AI — провайдер моделей генерации видео (Dream Machine, Ray) и 3D. Текст-в-видео и видео-в-видео с поддержкой keyframes и расширенных управлений камерой.

Официальный сайт: https://lumalabs.ai

Документация модели у вендора: https://docs.lumalabs.ai/docs/api