Luma Ray 1.6 T2V API Documentation

Luma Ray 1.6 T2V API Documentation

Playground

Luma Ray 1.6 generates high-quality videos from text prompts, with support for multiple sizes and advanced prompt optimization. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Create cinematic videos from pure imagination with Luma Ray 1.6 Text-to-Video. Simply describe your scene and watch it come to life — no source images required. Ray 1.6 excels at magical, fantastical, and visually stunning content with professional-grade camera work.

Need to animate an existing image? Try Luma Ray 1.6 I2V for image-to-video generation.

Why It Looks Great

• Pure text-to-video: Generate complete videos from descriptions alone — no images needed.
• Cinematic quality: Creates movie-grade videos with dramatic lighting and composition.
• Fantasy & magical: Excels at luminous, ethereal, and fantastical scenes.
• Advanced camera work: Supports tracking shots, following movements, and dynamic angles.
• 720p HD output: Sharp, professional-quality video in landscape or portrait.
• Extended duration: Generate up to 10 seconds of video.
• Prompt Enhancer: Built-in tool to refine your descriptions automatically.

Parameters

How to Use

1. Write your prompt — describe the scene, camera movements, and atmosphere in detail.
2. Use Prompt Enhancer (optional) — click to automatically enrich your description.
3. Choose size — select landscape (1280×720) or portrait (720×1280).
4. Set duration — choose 5 or 10 seconds.
5. Run — click the button to generate.
6. Download — preview and save your video.

Pricing

Per 5-second billing based on duration.

Size Options

Best Use Cases

• Fantasy & Magical Content — Create ethereal, luminous, and fantastical scenes.
• Cinematic Sequences — Generate movie-quality video from imagination.
• Nature & Wildlife — Produce stunning wildlife and nature footage.
• Music Videos — Create visually stunning sequences for audio content.
• Concept Visualization — Bring imaginative ideas to life without source material.

Example Prompts

• “A luminous deer walks through a forest made of giant, translucent crystals. The crystals refract moonlight, casting colorful light patterns on the ground. Magical, tranquil atmosphere, cinematic, 4K, camera follows the deer’s movement slowly.”
• “Dragon soaring through clouds at sunset, golden light on scales, epic aerial shot”
• “Bioluminescent jellyfish floating in deep ocean, ethereal glow, slow graceful movement”
• “Ancient temple emerging from mist at dawn, time-lapse clouds, mystical atmosphere”
• “Phoenix rising from flames, sparks and embers swirling, dramatic slow motion”

Model Comparison

Pro Tips for Best Results

• Ray excels at magical and fantastical content — embrace the ethereal.
• Include cinematic direction: “camera follows”, “tracking shot”, “slow motion”.
• Describe light qualities: “luminous”, “refract moonlight”, “colorful light patterns”.
• Add atmosphere keywords: “magical”, “tranquil”, “cinematic”, “4K”.
• Combine subject action with camera movement for dynamic results.
• Fantasy creatures, glowing elements, and nature scenes work exceptionally well.

Notes

• Duration options are 5 or 10 seconds.
• Text-to-video costs more than image-to-video due to full scene generation.
• Enable Safety Checker for content that will be publicly shared.
• Ray 1.6 delivers Luma’s latest and most capable video generation.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "size": "1280*720",
  "duration": 5
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/luma/ray-1.6-t2v" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; 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 type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  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

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters