Use Luma in OpenClaw.
Luma Ray 3.2 modifies existing video with prompt-driven transformations that preserve spatial coherence and 3D scene structure. Send a source video URL and a text prompt describing the transformation — Luma re-renders the footage with atmospheric lighting, environmental detail, and physically consistent camera motion. OpenClaw agents call it through the same RunAPI key used for chat.
Use RunAPI to modify a video with Luma Ray 3.2.
Requirements:
- Read the API key from RUNAPI_API_KEY.
- Call POST https://runapi.ai/api/v1/luma/modify_video
- Set model to "luma-modify-video".
- Set source_video_url to the URL of the video to transform.
- Set prompt to describe the desired transformation.
- The task is async. Poll the returned task_id until status is "completed".
- When done, read the modified video URL from the response output.
curl -X POST https://runapi.ai/api/v1/luma/modify_video \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "luma-modify-video",
"prompt": "Transform the scene into a foggy autumn morning with golden light filtering through trees",
"source_video_url": "https://example.com/park-walk.mp4"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "luma-modify-video"
}
Use Luma in OpenClaw in three steps
Configure RunAPI
Set RUNAPI_API_KEY in your environment. If you already configured RunAPI for chat in OpenClaw, the same key works for Luma video modification — no extra provider setup needed.
export RUNAPI_API_KEY=runapi_xxx
Call Luma modify_video
Send a POST request to the modify_video endpoint with model set to luma-modify-video, the source_video_url pointing to your input footage, and a prompt describing the transformation. Luma preserves the original scene geometry while applying the requested changes.
POST /api/v1/luma/modify_video
Poll for the result
The endpoint returns a task_id immediately. Poll the task status endpoint until the status is completed, then read the output video URL from the response. Video modification typically takes 30-120 seconds depending on complexity.
GET /api/v1/luma/modify_video/tsk_abc123
Luma modify_video API parameters
| Parameter | Type | Description |
|---|---|---|
model |
string |
Required. Use luma-modify-video. |
prompt |
string |
Required. Text description of the desired video transformation — style changes, lighting, atmosphere, or scene edits. |
source_video_url |
string |
Required. URL of the source video to modify. Must be a publicly accessible MP4 or MOV file. |
watermark |
boolean |
Optional. Whether to add a watermark to the output video. |
callback_url |
string |
Optional. Webhook URL that receives a POST when the task completes. |
What is Luma on OpenClaw?
Luma Ray 3.2 (Dream Machine) specializes in modifying existing video with a dreamlike quality that users describe as cinematic-looking and fast to iterate with. Rather than generating from scratch, it re-renders source footage with prompt-driven transformations -- atmospheric shifts, style conversions, and environmental changes -- while keeping the original spatial layout and camera motion intact. OpenClaw agents call it through RunAPI with the same API key used for chat.
Luma use cases
Mood pieces and music video aesthetics
Transform raw footage into stylized mood pieces with Luma's dreamlike visual quality. Change lighting, atmosphere, and color palette while preserving the original motion for music video concepts or art projects.
Quick visual hypotheses for ad directions
Restyle an existing product video in multiple visual directions -- cinematic, minimal, noir, or seasonal -- to test which look works before committing to a full reshoot.
Base footage for multi-tool pipelines
Use Luma to restyle generated or shot footage, then pass it to other tools for final editing. Luma's fast turnaround makes it practical as a styling step in a larger video pipeline.
Luma + OpenClaw questions
Luma modify_video re-renders existing footage with prompt-driven changes — atmospheric shifts (fog, rain, golden hour), style transfers (cinematic, anime, noir), lighting overhauls, and environmental transformations. It preserves the original camera motion and spatial layout of the scene.
Luma specializes in modifying existing video rather than generating from scratch. Its Ray 3.2 model maintains 3D spatial coherence during transformations, so objects keep their depth relationships and camera motion stays physically consistent. Models like Kling or Hailuo generate new video from text or images.
Asynchronous. The create endpoint returns a task_id immediately. Poll the task status endpoint or provide a callback_url to receive a webhook when the modified video is ready. Typical processing time is 30-120 seconds.
Luma uses flat per-task billing — each modify_video call costs a fixed amount regardless of video length. Check the RunAPI pricing page for current rates. Failed generations are not charged.
Yes. An OpenClaw agent can generate a video with Kling or Hailuo, then pass the output URL as source_video_url to Luma modify_video for post-processing — all through the same RUNAPI_API_KEY. Each step uses the same async polling pattern.
OpenClaw general setup
Not configured yet? Start with the RunAPI setup guide for OpenClaw.
OpenClaw setup guide →Try Luma in OpenClaw today.
Get a free RunAPI key, paste the prompt into OpenClaw, and start modifying video with Luma Ray 3.2 spatial-aware transformations.