Войти
Luma AIAPI видеоОт $0.042

Luma API

Luma API on WaveSpeedAI — Ray 3.2 text-to-video, image-to-video, video edit and video reframing, earlier Ray 2 and Ray 1.6 models, and Uni v1 and Photon image generation and editing, all through one REST API.

Use Luma's Ray 3.2 for cinematic text-to-video and image-to-video with controllable aspect ratio, resolution and duration, re-render or reframe existing footage with video edit and video reframing, and generate or edit images with Uni v1 and Photon. Ray 2 and Ray 1.6 stay available for earlier workflows.

Обзор

О модели Luma API

Что делает Luma, какое место занимает в линейке моделей Luma AI и почему её выбирают команды.

Luma — модель генерации видео от Luma AI, доступная через REST API WaveSpeedAI. Luma API on WaveSpeedAI — Ray 3.2 text-to-video, image-to-video, video edit and video reframing, earlier Ray 2 and Ray 1.6 models, and Uni v1 and Photon image generation and editing, all through one REST API.

Use Luma's Ray 3.2 for cinematic text-to-video and image-to-video with controllable aspect ratio, resolution and duration, re-render or reframe existing footage with video edit and video reframing, and generate or edit images with Uni v1 and Photon. Ray 2 and Ray 1.6 stay available for earlier workflows.

Семейство Luma в WaveSpeedAI включает 6 REST-эндпоинтов для сценариев: Video-To-Video, Image-To-Video, Text-To-Video, Image-To-Image, Text-To-Image. У каждого варианта свои цены, параметры и примеры результатов — выберите тот, что подходит под ваш тип входных данных и требования продакшена, или вызывайте несколько с одним API-ключом и собирайте многошаговые пайплайны.

Запускайте Luma с тем же API-ключом, платёжным аккаунтом и лимитами, что и остальные 1000+ ИИ-моделей WaveSpeedAI. Без отдельной регистрации у вендора, без SDK для каждого провайдера, без разных лимитов у каждого поставщика — одна интеграция охватывает всё: от текста в изображение и текста в видео до синтеза аудио, 3D-генерации, апскейлинга и редактирования.

Эндпоинты

Все эндпоинты API Luma

Сейчас в WaveSpeedAI доступно эндпоинтов Luma: 6 — выберите вариант под ваш сценарий.

video-to-videoRay 3.2 Video Edit — превью video-to-video Luma от Luma AI

Ray 3.2 Video Edit

Luma Ray 3.2 Video Edit is a fast AI video-to-video editing model that re-renders an existing source video from a text prompt while preserving the original motion and timing. Ready-to-use REST inference API for video restyling, creative edits, product videos, advertising creatives, social media clips, visual storytelling, and professional video editing workflows with simple integration, no coldstarts, and affordable pricing.

от $0.144
video-to-videoRay 3.2 Video Reframing — превью video-to-video Luma от Luma AI

Ray 3.2 Video Reframing

Luma Ray 3.2 Video Reframing is a fast AI video reframing model that changes an existing video’s aspect ratio and fills the newly exposed canvas from a prompt while preserving the source footage. Ready-to-use REST inference API for aspect ratio conversion, social media resizing, cinematic reframing, video outpainting, creator content, advertising creatives, and professional video editing workflows with simple integration, no coldstarts, and affordable pricing.

от $0.06
image-to-videoRay 3.2 Image To Video — превью image-to-video Luma от Luma AI

Ray 3.2 Image To Video

Luma Ray 3.2 Image to Video is a fast AI image-to-video generation model that animates a source image into cinematic video guided by a text prompt, with controllable aspect ratio, resolution, and duration. Ready-to-use REST inference API for image animation, cinematic clips, product videos, social media content, advertising creatives, visual storytelling, and professional image-to-video workflows with simple integration, no coldstarts, and affordable pricing.

от $0.10
text-to-videoRay 3.2 Text To Video — превью text-to-video Luma от Luma AI

Ray 3.2 Text To Video

Luma Ray 3.2 Text to Video is a fast AI video generation model that creates cinematic videos from text prompts with controllable aspect ratio, resolution, and duration. Ready-to-use REST inference API for cinematic clips, storytelling videos, social media content, advertising creatives, product visuals, concept videos, and professional text-to-video workflows with simple integration, no coldstarts, and affordable pricing.

от $0.10
image-to-imageUni v1 Edit — превью image-to-image Luma от Luma AI

Uni v1 Edit

Luma Uni v1 Edit is a fast AI image editing model that reworks source images from text instructions while preserving composition and supporting optional reference images. Ready-to-use REST inference API for photo editing, product image updates, creative retouching, marketing assets, brand visuals, style changes, and professional image editing workflows with simple integration, no coldstarts, and affordable pricing.

от $0.042
text-to-imageUni v1 Text To Image — превью text-to-image Luma от Luma AI

Uni v1 Text To Image

Luma Uni v1 Text to Image is a fast AI image generation model that creates high-fidelity images from prompts with flexible aspect ratios, visual style control, and optional reference-image guidance. Ready-to-use REST inference API for creative design, marketing visuals, product mockups, brand assets, social media content, concept art, and professional text-to-image workflows with simple integration, no coldstarts, and affordable pricing.

от $0.042

Примеры

Luma в деле

Реальные результаты, созданные через API Luma. Наведите курсор на видео для предпросмотра, нажмите, чтобы открыть в полном размере.

Как использовать

Как использовать API Luma

Четыре шага от регистрации до готовой генерации. Полные примеры на Python, Node.js и cURL — в разделе API ниже.

  1. 01

    Получите API-ключ

    Создайте аккаунт WaveSpeedAI и скопируйте API-ключ на панели управления. Новые аккаунты получают бесплатные стартовые кредиты — их хватит, чтобы несколько десятков раз запустить playground до начала списаний.

  2. 02

    Отправьте предсказание

    Отправьте входные данные в формате JSON методом POST на https://api.wavespeed.ai/api/v3/luma/ray-3.2/text-to-video. Эндпоинт сразу возвращает id предсказания — генерация асинхронная, поэтому соединение не нужно держать открытым на время инференса.

  3. 03

    Опрашивайте до завершения

    Выполняйте GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. При статусе completed забирайте результат; при failed, cancelled, timeout или deleted остановитесь с ошибкой; при любом другом статусе продолжайте опрос.

  4. 04

    Получите URL результата

    Когда статус станет "completed", возьмите URL из data.outputs[0]. Он указывает на созданный файл в CDN WaveSpeedAI — изображение, видео, аудио или 3D-файл, в зависимости от вызванного варианта Luma.

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

Что можно создать с Luma

Типичные сценарии, для которых разработчики и авторы используют API Luma.

01

Cinematic text-to-video

luma/ray-3.2/text-to-video generates cinematic videos from text prompts with controllable aspect ratio, resolution, duration and optional reference images.

text-to-videocinematic
02

Animate a still image

luma/ray-3.2/image-to-video animates a source image into video guided by a text prompt, with the same aspect ratio, resolution and duration controls.

image-to-video
03

Restyle footage and keep the motion

luma/ray-3.2/video-edit re-renders an existing source video from a text prompt while preserving the source motion and timing.

video-editrestyle
04

Reframe video to a new aspect ratio

luma/ray-3.2/video-reframing changes a video's aspect ratio and fills the newly exposed canvas from a prompt while preserving the source footage.

video-reframingaspect-ratio
05

Image generation and editing

luma/uni-v1/text-to-image generates images with aspect ratio, style, format and reference-image guidance; luma/uni-v1/edit transforms an input image from a text instruction while preserving composition.

text-to-imageimage-edit

Советы

Советы по написанию запросов для Luma

Практические советы, как получать лучшие результаты от Luma, — на основе приёмов, которые работают в продакшен-пайплайнах для моделей видео.

  1. 01

    Конкретно описывайте движения камеры

    Используйте конкретную операторскую лексику — orbit, dolly-in, push-in, pan-left, crane shot, handheld follow. Общие промпты дают статичную или произвольную камеру; названные движения камеры напрямую соответствуют замыслу движения в данных обучения модели и заметно улучшают кадр.

  2. 02

    Закрепляйте облик героя референсными изображениями

    Если промпт зависит от конкретного человека, персонажа или продукта, загрузите референсное изображение вместе с промптом. Без референса облик «плывёт» между кадрами и сценами — один и тот же персонаж в каждой генерации выглядит чуть иначе.

  3. 03

    Описывайте освещение и время суток

    Подсказки об освещении вроде 'golden hour, soft warm directional light' или 'overcast diffused light, slate-grey sky' улучшают качество и согласованность гораздо сильнее, чем расплывчатые модификаторы качества. Освещение — один из самых сильных факторов, на которые опирается модель.

  4. 04

    Используйте негативные промпты, чтобы подавить типичные сбои

    Полезные негативные подсказки для видео: 'frame flicker, motion blur, watermark, text artifacts, distorted hands, low resolution, jpeg compression'. Негативные промпты ничего не стоят и заметно снижают долю генераций, которые иначе пришлось бы перезапускать.

  5. 05

    Выбирайте самую короткую длительность, которая передаёт ваш эпизод

    Большинство промптов лучше всего работают на 5–8 секундах. Более длинные клипы усиливают временные несоответствия (изменение героя, «уплывание» окружения). Если нужна 20-секундная последовательность, создайте три клипа по 6–8 секунд и смонтируйте их — качество останется выше, чем в одной длинной генерации.

  6. 06

    Сразу выбирайте соотношение сторон под платформу

    9:16 — для TikTok / Reels / Shorts, 16:9 — для горизонтальных лент и YouTube, 1:1 — для сеток постов. Модели обучаются немного по-разному для разных соотношений сторон — кадрирование 16:9 в 9:16 постфактум теряет и детализацию, и композицию, задуманную моделью.

Цены

Цены на API Luma

Оплата — за каждый результат. Итоговая стоимость зависит от параметров, заданных в playground каждого варианта (разрешение, длительность, количество результатов, референсы).

Цена от

$0.042

Эндпоинтов: 6 · Luma

Открыть Playground
ЭндпоинтТипЦена от
luma/ray-3.2/video-editvideo-to-video$0.144
luma/ray-3.2/video-reframingvideo-to-video$0.06
luma/ray-3.2/image-to-videoimage-to-video$0.10
luma/ray-3.2/text-to-videotext-to-video$0.10
luma/uni-v1/editimage-to-image$0.042
luma/uni-v1/text-to-imagetext-to-image$0.042

API

Вызов API Luma

Получите API-ключ на wavespeed.ai/accesskey, затем отправьте предсказание через REST. Playground генерирует готовые к вставке примеры для любой комбинации входных данных.

POSThttps://api.wavespeed.ai/api/v3/luma/ray-3.2/text-to-video

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/luma/ray-3.2/text-to-video" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "size": "16:9",
    "resolution": "540p",
    "duration": 5
}')

TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
    -H "Authorization: Bearer $WAVESPEED_API_KEY")
  RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
  STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
  case "$STATUS" in
    completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done

Сравнение

Luma и альтернативы

Когда стоит выбрать Luma, а не похожие модели в WaveSpeedAI.

Luma и Kling 3.0

Kling 3.0 offers Standard, Pro and 4K tiers with native audio. Luma Ray 3.2 adds video edit and video reframing endpoints for working on existing footage.

Luma и Veo 3.1

Veo 3.1 is Google's video model with synchronized audio. Luma Ray 3.2 is a separate family with optional reference images and footage-level edit and reframing endpoints.

FAQ

Luma API — часто задаваемые вопросы

Цены, лицензия, интеграция — частые вопросы о запуске Luma в WaveSpeedAI.

Что такое API Luma?

Luma — модель генерации видео от Luma AI, доступная как REST API в WaveSpeedAI. Luma API on WaveSpeedAI — Ray 3.2 text-to-video, image-to-video, video edit and video reframing, earlier Ray 2 and Ray 1.6 models, and Uni v1 and Photon image generation and editing, all through one REST API. Её можно вызывать программно или попробовать в playground по ссылке выше.

Как вызывать API Luma?

Создайте аккаунт WaveSpeedAI, скопируйте API-ключ на странице /accesskey и отправьте POST на https://api.wavespeed.ai/api/v3/luma/ray-3.2/text-to-video с входными данными в JSON. Эндпоинт вернёт id предсказания. Опрашивайте эндпоинт результата примерно раз в 2 секунды, для долгих задач увеличивайте интервал и останавливайтесь на любом финальном статусе. Примеры для продакшена на Python / Node.js / cURL — выше.

Сколько стоит API Luma?

Luma стоит от $0.042. Точная стоимость зависит от заданных параметров (разрешение, длительность, количество результатов, референсы). Предпросмотр стоимости рядом с кнопкой «Сгенерировать» в playground показывает точную цену для ваших текущих данных.

Какие варианты Luma доступны?

В WaveSpeedAI доступно рабочих эндпоинтов Luma: 6 — luma/ray-3.2/video-edit, luma/ray-3.2/video-reframing, luma/ray-3.2/image-to-video, luma/ray-3.2/text-to-video, luma/uni-v1/edit, luma/uni-v1/text-to-image. У каждого варианта своя страница playground и свои цены.

Можно ли использовать результаты Luma в коммерческих целях?

Права на коммерческое использование определяются лицензией модели Luma AI. Большинство моделей Luma AI разрешают коммерческое использование результатов; краткое описание лицензии смотрите на странице playground каждой модели, а условия платформы — в Условиях использования WaveSpeedAI.

Зачем использовать Luma в WaveSpeedAI, а не напрямую?

Один API-ключ и один платёжный аккаунт для Luma И для 1000+ других ИИ-моделей от разных провайдеров. Без настройки SDK для каждого вендора, без отдельных лимитов, без переписывания интеграционного кода под каждого поставщика. Цены, как правило, на уровне прямого API Luma AI или ниже.

Начните создавать с Luma в WaveSpeedAI

Бесплатные стартовые кредиты при регистрации. Один API-ключ для 1000+ ИИ-моделей от Luma AI и всех остальных провайдеров.