ГлавнаяМоделиГенерация видеоLuma Ray 2

Luma Ray 2

ПровайдерLuma

luma-dream-machine — генерация видео-модель от Luma.

image_to_videotext_to_video

Что умеет Luma Ray 2

  • Image-to-video
  • Text-to-video

Стоимость

за секунду
Ray 2
112 ₽

Цены указаны в рублях и списываются с баланса проекта за успешные запросы. Надбавки (+) суммируются с базовой ставкой.

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

Vendor
luma
Modality
video

Параметры запроса

Параметры, которые принимает модель. Передаются в теле запроса.

ПараметрТипДиапазон / значенияПо умолчаниюОписание
promptreq
string
—
—
Текстовое описание желаемого видео. Camera motions добавлять прямо в prompt (например "camera orbit left").
1 пример
Примеры
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}
ПолеТипЗначенияОписание
frame0object—Стартовый кадр: {type: "image", url} или {type: "generation", id}.
frame1object—Финальный кадр: {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
ПолеТипЗначенияОписание
keyreqstring—Идентификатор концепта (например "dolly_zoom"). Полный список: GET /v1/generations/concepts/list.
[
  {
    "key": "dolly_zoom"
  }
]
callback_url
string
—
—
URL для POST-уведомлений при изменении статуса (dreaming / completed / failed). Может вызываться несколько раз. Ожидается 200; иначе ретрай 3 раза с задержкой 100ms, timeout 5s.
1 пример
Примеры
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
—

Пример кода

luma-dream-machine_example.py
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)
Полная документация модели