ГлавнаяДокументацияМоделиLuma Ray 2 Flash
Генерация видео · luma

Luma Ray 2 Flash

ray-flash-2

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

от 28 ₽ / сек

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

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

МодальностьГенерация видео
Провайдерluma
СтатусАктивна
ID для запросовray-flash-2

Возможности

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

Цены

ЕдиницаЦена
за секунду28 ₽

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

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

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

ПараметрТипДиапазон / valuesDefaultОписание
promptrequiredstring—— Текстовое описание желаемого видео. Camera motions добавлять прямо в prompt (например "camera orbit left").
примеры значений
Примеры
A tiger walking in snow, slow motion, cinematic lighting.
resolutionenum540p, 720p, 1080p, 4k720p Разрешение видео. 4k — самое дорогое.
durationenum5s, 9s5s Длительность видео. Передаётся как строка с суффиксом s.
aspect_ratioenum1:1, 16:9, 9:16, 4:3, 3:4, 21:916:9 Соотношение сторон видео.
loopboolean—false Зацикленное видео (loop). Финальный кадр плавно переходит в первый.
keyframesobject—— Ключевые кадры для 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"
  }
}
conceptsarray 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_urlstring—— 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-режима.

ПолеТипЗначенияОписание
idstring— task_id для GET /v1/tasks/{id}.
objectstringvideo.task
statusenumqueued, processing, completed, failed
modelstring—
createdinteger—

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

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

ПолеТипЗначенияОписание
idstring—
statusenumqueued, processing, completed, failed, canceled
modalitystringvideo
modelstring—
dataarray—
Каждый элемент:
  • url— string · CDN URL .mp4 / .webm / .mov.
errorstring—

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

from openai import OpenAI

client = OpenAI(api_key="rk_live_...", base_url="https://api.ranvik.ru/v1")
resp = client.videos.generate(
    model= "ray-flash-2",
    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