Luma AI影片 API$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 的影片生成模型,可透過 WaveSpeedAI REST 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.

WaveSpeedAI 上的 Luma 系列提供 6 個 REST 端點,涵蓋 Video-To-Video, Image-To-Video, Text-To-Video, Image-To-Image, Text-To-Image 等工作流程。每個變體都有各自的定價、參數選項與範例輸出 — 請挑選符合您輸入模態與生產限制的版本,或使用同一組 API 金鑰呼叫多個變體,組合成多步驟的處理流程。

使用您呼叫其他 1,000+ 個 WaveSpeedAI AI 模型時相同的 API 金鑰、帳單帳戶與速率限制額度來執行 Luma。無需另外設定供應商、無需各家 SDK、無需處理各家不同的速率限制 — 一次整合,涵蓋從文字轉圖片、文字轉影片,到音訊合成、3D 生成、放大與編輯的所有功能。

端點

所有 Luma API 端點

WaveSpeedAI 目前提供 6 個 Luma 端點 — 請選擇符合您工作流程的變體。

video-to-videoRay 3.2 Video Edit — Luma AI 的 Luma video-to-video 預覽

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 — Luma AI 的 Luma video-to-video 預覽

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 — Luma AI 的 Luma image-to-video 預覽

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 — Luma AI 的 Luma text-to-video 預覽

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 — Luma AI 的 Luma image-to-image 預覽

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 — Luma AI 的 Luma text-to-image 預覽

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 的實際效果

由 Luma API 生成的真實輸出。將滑鼠移到任一影片上即可預覽,點擊可開啟完整尺寸檢視器。

使用方式

如何使用 Luma API

從註冊到完成生成,只要四個步驟。完整的 Python、Node.js 與 cURL 範例請見下方的 API 區段。

  1. 01

    取得 API 金鑰

    註冊 WaveSpeedAI 帳號,並從控制台複製您的 API 金鑰。新帳號會獲贈免費入門點數 — 足以在開始計費前執行數十次 Playground。

  2. 02

    提交 prediction

    將您的輸入以 JSON 格式 POST 到 https://api.wavespeed.ai/api/v3/luma/ray-3.2/text-to-video。端點會立即回傳 prediction id — 生成是非同步進行的,因此推論期間您不需要保持連線。

  3. 03

    輪詢完成狀態

    GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result。狀態為 completed 時回傳輸出;狀態為 failed、cancelled、timeout 或 deleted 時停止並回報錯誤;其他狀態則持續輪詢。

  4. 04

    讀取輸出網址

    當狀態為 "completed" 時,從 data.outputs[0] 讀取網址。該網址指向 WaveSpeedAI CDN 上您生成的媒體 — 依您呼叫的 Luma 變體,可能是圖片、影片、音訊或 3D 檔案。

應用情境

您可以用 Luma 打造什麼

開發者與創作者使用 Luma API 的常見工作流程。

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

    明確描述運鏡

    請使用具體的攝影術語,例如環繞、推軌、推近、左搖、升降鏡頭、手持跟拍。籠統的提示詞會得到靜態或隨機的運鏡;具名的運鏡方式能直接對應模型訓練資料中的動態意圖,大幅提升鏡頭品質。

  2. 02

    以參考圖片鎖定角色身分

    若提示詞依賴特定的人物、角色或產品,請在提示詞之外上傳參考圖片。沒有參考的話,身分會在畫格與鏡頭之間飄移,同一個角色每次生成都會長得略有不同。

  3. 03

    描述光線與時段

    「黃金時刻,柔和溫暖的定向光」或「陰天漫射光,石板灰的天空」這類光線提示,比含糊的畫質修飾語更能提升畫質與一致性。光線是模型最強的先驗條件之一。

  4. 04

    使用負面提示詞抑制常見失誤

    影片常用的負面詞:「畫格閃爍、動態模糊、浮水印、文字瑕疵、變形的手、低解析度、JPEG 壓縮」。負面提示詞不需額外成本,卻能明顯減少原本需要重新生成的次數。

  5. 05

    選擇能涵蓋重點的最短時長

    多數提示詞在 5 至 8 秒時效果最好。較長的影片會放大時間上的不一致(主體變形、環境漂移)。若需要 20 秒的片段,請生成三段 6 至 8 秒的影片再剪輯在一起,畫質會比單次生成一段長影片更高。

  6. 06

    預先配合平台設定長寬比

    TikTok / Reels / Shorts 用 9:16,橫式動態與 YouTube 用 16:9,貼文版面用 1:1。模型對不同長寬比的訓練略有差異,事後將 16:9 裁切為 9:16 會損失畫質,也失去模型原本設計的構圖。

定價

Luma API 定價

依輸出計費。最終費用會依您在各變體 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

呼叫 Luma API

請到 wavespeed.ai/accesskey 註冊取得 API 金鑰,然後透過 REST 提交 prediction。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 與其他選擇比較

在 WaveSpeedAI 上,何時該選擇 Luma 而非類似的模型。

Luma vs 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 vs 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.

常見問題

Luma API — 常見問題

定價、授權、整合 — 關於在 WaveSpeedAI 上執行 Luma 的常見問題。

什麼是 Luma API?

Luma 是 Luma AI 的影片生成模型,在 WaveSpeedAI 上以 REST 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.您可以透過程式呼叫,也可以在上方連結的 Playground 試用。

如何呼叫 Luma API?

註冊 WaveSpeedAI 帳號,從 /accesskey 複製您的 API 金鑰,然後將您的輸入以 JSON 格式 POST 到 https://api.wavespeed.ai/api/v3/luma/ray-3.2/text-to-video。端點會回傳 prediction id。請從約每 2 秒輪詢一次結果端點開始,長時間任務可拉長間隔,並在任何終止狀態時停止。上方提供適用於生產環境的 Python / Node.js / cURL 範例。

Luma API 的費用是多少?

Luma $0.042 起。實際費用會依您設定的參數(解析度、時長、輸出數量、參考素材)而調整。Playground 中「生成」按鈕旁的即時費用預覽會顯示您目前輸入的確切價格。

有哪些 Luma 變體可用?

WaveSpeedAI 提供 6 個已上線的 Luma 端點: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 的服務條款了解平台層級的條件。

為什麼要在 WaveSpeedAI 上使用 Luma,而不是直接使用?

一組 API 金鑰、一個帳單帳戶,即可使用 Luma 以及來自其他供應商的 1,000+ 個 AI 模型。無需設定各家 SDK、無需處理各自獨立的速率限制、無需為每個供應商重寫整合程式碼。價格通常與 Luma AI 的直接 API 相當或更低。

在 WaveSpeedAI 上開始使用 Luma 打造應用

註冊即贈免費入門點數。一組 API 金鑰,涵蓋來自 Luma AI 與所有其他供應商的 1,000+ 個 AI 模型。