Luma Ray-3.2

This documentation is valid for the following list of our models:

• luma/ray-3.2

Try in Playground

Model Overview

Luma Ray-3.2 generates, edits, and reframes videos from text or images with HDR output, multi-keyframe control, and seamless looping.

Setup your API Key

If you don't have an API key yet, use our Quickstart guide.

How to Make a Call

Step-by-Step Instructions

Generating a video involves sequentially calling two endpoints:

• Create and submit a video generation task. The response contains a generation ID.

• Poll the retrieval endpoint with that generation ID until the status is completed.

API Schemas

Create a video generation task and send it to the server

post

Body

application/json

modelstring · enumRequiredPossible values:

promptstringRequired

Text description of the video to generate.

typestring · enumOptional

Generation kind: "video" (generate / extend), "video_edit", or "video_reframe".

Default: videoPossible values:

resolutionstring · enumOptional

Output resolution.

Default: 720pPossible values:

durationinteger · enumOptional

Clip duration in seconds.

Default: 5Possible values:

aspect_ratiostring · enumOptional

Output aspect ratio.

Default: 16:9Possible values:

loopbooleanOptional

Seamlessly loop the video (creation only).

Default: false

hdrbooleanOptional

Generate HDR output (5s, 720p/1080p only).

Default: false

exr_exportbooleanOptional

Export EXR frames (requires hdr).

Default: false

image_urlstring · uriOptional

Start-frame image URL for image-to-video / extend.

last_image_urlstring · uriOptional

End-frame image URL (first-last-frame).

video_urlstring · uriOptional

Source video URL for editing or reframing.

Responses

200

Successful response.

application/json

idstringRequired

The ID of the generated video.

Example: 60ac7c34-3224-4b14-8e7d-0aa0db708325

statusstring · enumRequired

The current status of the generation task.

Example: completedPossible values:

post/v2/video/generations

cURLJavaScriptPython

curl --request POST \
  --url 'https://api.aimlapi.com/v2/video/generations' \
  --header 'Authorization: Bearer <YOUR_AIMLAPI_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{"model": "luma/ray-3.2", "prompt": "Describe what you want the model to generate.", "duration": "5", "image_url": "https://example.com/input.jpg"}'

200

Successful response.

{
  "id": "60ac7c34-3224-4b14-8e7d-0aa0db708325",
  "status": "completed",
  "video": {
    "url": "https://cdn.aimlapi.com/generations/hedgehog/1759866285599-0cdfb138-c03a-49d4-a601-4f6413e27b15.mp4"
  },
  "error": {
    "name": "text",
    "message": "text"
  },
  "meta": {
    "usage": {
      "credits_used": 120000,
      "usd_spent": 0.06
    }
  }
}

Retrieve the generated video from the server

Poll this endpoint with the generation_id returned by the submit request. When the status is completed, the response includes the generated video URL.

get

Authorizations

access-token

AuthorizationstringRequired

Bearer key

Query parameters

generation_idstringRequiredExample: <REPLACE_WITH_YOUR_GENERATION_ID>

Responses

200Success

application/json

idstringRequired

The ID of the generated video.

Example: 60ac7c34-3224-4b14-8e7d-0aa0db708325

statusstring · enumRequired

The current status of the generation task.

Example: completedPossible values:

get/v2/video/generations

cURLJavaScriptPython

curl -L \
  --request GET \
  --url 'https://api.aimlapi.com/v2/video/generations?generation_id=<REPLACE_WITH_YOUR_GENERATION_ID>' \
  --header 'Authorization: Bearer <YOUR_AIMLAPI_KEY>'

200Success

{
  "id": "60ac7c34-3224-4b14-8e7d-0aa0db708325",
  "status": "completed",
  "video": {
    "url": "https://cdn.aimlapi.com/generations/hedgehog/1759866285599-0cdfb138-c03a-49d4-a601-4f6413e27b15.mp4"
  },
  "error": {
    "name": "text",
    "message": "text"
  },
  "meta": {
    "usage": {
      "credits_used": 120000
    }
  }
}

Code Example

The examples submit a generation task and poll every 15 seconds until the final result is available.

Python

import requests
import time

api_key = "<YOUR_AIMLAPI_KEY>"
url = "https://api.aimlapi.com/v2/video/generations"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json",
}

generation = requests.post(url, headers=headers, json={'model': 'luma/ray-3.2', 'prompt': 'Describe what you want the model to generate.', 'duration': '5', 'image_url': 'https://example.com/input.jpg'})
generation.raise_for_status()
generation_id = generation.json()["id"]

while True:
    result = requests.get(
        url,
        headers=headers,
        params={"generation_id": generation_id},
    )
    result.raise_for_status()
    data = result.json()
    if data.get("status") not in ("queued", "generating"):
        print(data)
        break
    time.sleep(15)

JavaScript

Response

{
  "id": "60ac7c34-3224-4b14-8e7d-0aa0db708325",
  "status": "completed",
  "video": {
    "url": "https://cdn.aimlapi.com/generations/hedgehog/1759866285599-0cdfb138-c03a-49d4-a601-4f6413e27b15.mp4"
  },
  "error": {
    "name": "<name>",
    "message": "<message>"
  },
  "meta": {
    "usage": {
      "credits_used": 120000,
      "usd_spent": 0.06
    }
  },
  "model": "luma/ray-3.2"
}