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.
Genel Bakış
Luma API Hakkında
Luma ne yapar, Luma AI model yelpazesindeki yeri nedir ve ekipler neden onu tercih eder.
Luma, Luma AI tarafından geliştirilen bir video üretimi modelidir ve WaveSpeedAI REST API'si üzerinden kullanılabilir. 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.
WaveSpeedAI'daki Luma ailesi, Video-To-Video, Image-To-Video, Text-To-Video, Image-To-Image, Text-To-Image iş akışını kapsayan 6 REST uç noktası sunar. Her varyantın kendi fiyatı, parametre seçenekleri ve örnek çıktıları vardır — girdi türünüze ve üretim gereksinimlerinize uyanı seçin ya da çok adımlı işlem hatları kurmak için aynı API anahtarıyla birkaçını birlikte çağırın.
Luma modelini, WaveSpeedAI'daki diğer 1.000+ AI modeli için kullandığınız aynı API anahtarı, faturalandırma hesabı ve hız sınırı çerçevesi üzerinden çalıştırın. Ayrı bir sağlayıcı kurulumu, sağlayıcıya özel SDK'lar veya sağlayıcıya özel hız sınırları yok — tek bir entegrasyon, metinden görsele ve metinden videoya, ses sentezi, 3D üretimi, büyütme ve düzenlemeye kadar her şeyi kapsar.
Uç Noktalar
Tüm Luma API uç noktaları
WaveSpeedAI'da şu anda 6 Luma uç noktası kullanılabilir — iş akışınıza uyan varyantı seçin.
/filters:quality(82)/media/images/1782717317688496873_qX6fpyHQ.webp)
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.
/filters:quality(82)/media/images/1782717390795771980_eQLU3clv.webp)
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.
/filters:quality(82)/media/images/1781079452793266676_0T2d6enx.webp)
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.
/filters:quality(82)/media/images/1781079292182866010_NdMW5fpz.webp)
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.
/filters:quality(82)/media/images/1781079512370971296_kmKPCCyz.webp)
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.
/filters:quality(82)/media/images/1781079484942032323_VCwGPY8i.webp)
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.
Örnekler
Luma iş başında
Luma API'siyle üretilmiş gerçek çıktılar. Önizlemek için bir videonun üzerine gelin, tam boyutlu görüntüleyiciyi açmak için tıklayın.
Nasıl Kullanılır
Luma API'si nasıl kullanılır
Kayıttan tamamlanmış bir üretime dört adım. Python, Node.js ve cURL örneklerinin tamamı aşağıdaki API bölümünde.
- 01
API anahtarı alın
Bir WaveSpeedAI hesabı oluşturun ve API anahtarınızı kontrol panelinden kopyalayın. Yeni hesaplar ücretsiz başlangıç kredisiyle gelir — faturalandırma başlamadan önce playground'u birkaç düzine kez çalıştırmaya yeter.
- 02
Tahmin gönderin
Girdinizi JSON olarak https://api.wavespeed.ai/api/v3/luma/ray-3.2/text-to-video adresine POST edin. Uç nokta hemen bir tahmin kimliği döndürür — üretimler asenkrondur, bu yüzden çıkarım sırasında açık bir bağlantı tutmanız gerekmez.
- 03
Tamamlanmayı yoklayın
https://api.wavespeed.ai/api/v3/predictions/{request_id}/result adresine GET isteği gönderin. completed durumunda çıktıları alın; failed, cancelled, timeout veya deleted durumunda hata ile durun; diğer tüm durumlarda yoklamaya devam edin.
- 04
Çıktı URL'sini okuyun
Durum "completed" olduğunda URL'yi data.outputs[0] alanından okuyun. URL, WaveSpeedAI CDN'indeki üretilmiş medyanıza işaret eder — çağırdığınız Luma varyantına göre görsel, video, ses veya 3D dosyası.
Kullanım Alanları
Luma ile neler geliştirebilirsiniz
Geliştiricilerin ve içerik üreticilerin Luma API'sini kullandığı yaygın iş akışları.
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.
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.
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.
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.
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.
İpuçları
Luma için istem yazma ipuçları
Luma ile daha iyi çıktı almak için pratik öneriler — üretim hatlarında video modelleri genelinde işe yarayan yöntemlerden derlendi.
- 01
Kamera hareketleri konusunda net olun
Somut sinematografi sözcüklerini kullanın — orbit, dolly-in, push-in, pan-left, crane shot, handheld follow. Genel istemler statik veya rastgele kamera seçimleri üretir; adlandırılmış kamera hareketleri modelin eğitim verisinde hareket niyetiyle doğrudan eşleşir ve çekim kalitesini önemli ölçüde artırır.
- 02
Karakter kimliğini referans görsellerle sabitleyin
İsteminiz belirli bir kişiye, karaktere veya ürüne bağlıysa, istemin yanına bir referans görsel yükleyin. Referans olmadan kimlik, kareler ve çekimler arasında kayar — aynı karakter her üretimde biraz farklı bir kişiye benzer.
- 03
Işığı ve günün saatini tarif edin
'Altın saat, yumuşak sıcak yönlü ışık' veya 'bulutlu dağınık ışık, arduvaz grisi gökyüzü' gibi ışık ipuçları, belirsiz kalite niteleyicilerinden çok daha fazla kalite ve tutarlılık sağlar. Işık, modelin koşullandığı en güçlü önsel bilgilerden biridir.
- 04
Yaygın hata kiplerini bastırmak için negatif istemleri kullanın
Video için yararlı negatifler: 'kare titremesi, hareket bulanıklığı, filigran, metin artefaktları, bozuk eller, düşük çözünürlük, jpeg sıkıştırma'. Negatif istemler hiçbir şeye mal olmaz ve aksi halde yeniden çevireceğiniz üretimlerin oranını gözle görülür ölçüde azaltır.
- 05
Vuruşunuzu yakalayan en kısa süreyi seçin
Çoğu istem 5-8 saniyede en iyi çalışır. Daha uzun klipler zamansal tutarsızlıkları (öznenin biçim değiştirmesi, ortam kayması) büyütür. 20 saniyelik bir diziye ihtiyacınız varsa, üç adet 6-8 saniyelik klip üretip birlikte kurgulayın — kalite tek bir uzun üretimden yüksek kalır.
- 06
En-boy oranını baştan platforma uydurun
TikTok / Reels / Shorts için 9:16, yatay akışlar ve YouTube için 16:9, gönderi ızgaraları için 1:1. Modeller en-boy oranına göre biraz farklı eğitilir — 16:9'u sonradan 9:16'ya kırpmak hem doğruluğu hem de modelin amaçladığı kompozisyonu kaybettirir.
Fiyatlandırma
Luma API fiyatlandırması
Fiyatlandırma çıktı başınadır. Nihai ücret, her varyantın playground'unda belirlediğiniz parametrelere (çözünürlük, süre, çıktı sayısı, referanslar) göre değişir.
| Uç Nokta | Tür | Başlangıç fiyatı |
|---|---|---|
| luma/ | video-to-video | $0.144 |
| luma/ | video-to-video | $0.06 |
| luma/ | image-to-video | $0.10 |
| luma/ | text-to-video | $0.10 |
| luma/ | image-to-image | $0.042 |
| luma/ | text-to-image | $0.042 |
API
Luma API'sini çağırın
wavespeed.ai/accesskey adresinden bir API anahtarı alın, ardından REST ile bir tahmin gönderin. Playground, girdilerin her kombinasyonu için yapıştırmaya hazır örnekler üretir.
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
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/luma/ray-3.2/text-to-video";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"size": "16:9",
"resolution": "540p",
"duration": 5
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"size": "16:9",
"resolution": "540p",
"duration": 5
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/luma/ray-3.2/text-to-video", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Karşılaştır
Luma ve alternatifleri
WaveSpeedAI'daki benzer modeller yerine ne zaman Luma seçmeli.
Luma ve 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 ve 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.
SSS
Luma API — Sıkça sorulan sorular
Fiyatlandırma, lisans, entegrasyon — Luma modelini WaveSpeedAI'da çalıştırmaya dair sık sorulan sorular.
Luma API'si nedir?
Luma, WaveSpeedAI'da REST API olarak sunulan, Luma AI tarafından geliştirilmiş bir video üretimi modelidir. 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. Onu programatik olarak çağırabilir veya yukarıda bağlantısı verilen playground'dan deneyebilirsiniz.
Luma API'sini nasıl çağırırım?
Bir WaveSpeedAI hesabı oluşturun, API anahtarınızı /accesskey sayfasından kopyalayın, ardından girdinizi JSON olarak https://api.wavespeed.ai/api/v3/luma/ray-3.2/text-to-video adresine POST edin. Uç nokta bir tahmin kimliği döndürür. Sonuç uç noktasını yaklaşık 2 saniyede bir yoklayın, uzun süren görevlerde aralığı artırın ve herhangi bir son durumda durun. Üretime yönelik Python / Node.js / cURL örnekleri yukarıda.
Luma API'sinin maliyeti nedir?
Luma $0.042'dan başlar. Kesin maliyet, belirlediğiniz parametrelere (çözünürlük, süre, çıktı sayısı, referanslar) göre değişir. Playground'da Üret düğmesinin yanındaki canlı maliyet önizlemesi, mevcut girdiniz için kesin fiyatı gösterir.
Hangi Luma varyantları mevcut?
WaveSpeedAI, 6 canlı Luma uç noktası barındırır: 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. Her varyantın kendi playground sayfası ve fiyatı vardır.
Luma çıktılarını ticari amaçla kullanabilir miyim?
Ticari kullanım hakları Luma AI model lisansına tabidir. Çoğu Luma AI modeli çıktıların ticari kullanımına izin verir; lisans özeti için her modelin playground sayfasına, platform düzeyindeki koşullar için WaveSpeedAI Hizmet Koşulları'na bakın.
Luma modelini neden doğrudan kullanmak yerine WaveSpeedAI'da kullanmalıyım?
Luma ve diğer sağlayıcıların 1.000+ AI modeli için tek bir API anahtarı ve tek bir faturalandırma hesabı. Sağlayıcıya özel SDK kurulumu yok, ayrı hız sınırı çerçeveleri yok, her sağlayıcı için entegrasyon kodunu yeniden yazmak yok. Fiyatlar genellikle Luma AI'ın doğrudan API'siyle aynı düzeyde veya daha düşüktür.
WaveSpeedAI'da Luma ile geliştirmeye başlayın
Kayıt olunca ücretsiz başlangıç kredisi. Luma AI ve diğer tüm sağlayıcılardan 1.000+ AI modeli için tek API anahtarı.
/filters:quality(82)/examples/7090bb21305b0b99db644a0756b3a4ca/1783684141735187042_eUGQZ8ir.webp)