What kind of transformations can Luma modify_video do?

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.

How is Luma different from other video models on RunAPI?

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.

Is Luma modify_video synchronous or asynchronous?

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.

What does Luma video modification cost on RunAPI?

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.

Can I chain Luma with other RunAPI video models in one agent workflow?

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 + LUMA

OpenClaw で Luma を使う。

Luma Ray 3.2 は、空間的整合性と 3D シーン構造を保ったプロンプト駆動の変換で既存の動画を編集します。ソース動画の URL と変換を記述したテキストプロンプトを送ると、Luma が雰囲気のある照明、環境ディテール、物理的に一貫したカメラモーションで映像を再レンダリングします。OpenClaw のエージェントは、チャットと同じ RunAPI キーでこれを呼び出します。

API キーを取得ドキュメントを読む

1つの APIキー · 動画編集エンドポイント · 非同期タスクポーリング

RunAPI を使って Luma Ray 3.2 で動画を編集します。

要件：
- RUNAPI_API_KEY から API キーを読み込みます。
- POST https://runapi.ai/api/v1/luma/modify_video を呼び出します。
- model を "luma-modify-video" に設定します。
- source_video_url を変換する動画の URL に設定します。
- prompt に希望する変換内容を記述します。
- このタスクは非同期です。返された task_id を status が "completed" になるまでポーリングします。
- 完了したら、レスポンスの output から編集済み動画の URL を読み取ります。

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"
}

curlコマンドをコピーしてテスト luma

仕組み

OpenClaw で Luma を使う3ステップ

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 パラメータ

パラメータ	型	説明
`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.

OpenClaw上のLumaとは？

Luma Ray 3.2（Dream Machine）は既存動画を夢幻的な質感で変換することに特化しています。ゼロから生成するのではなく、プロンプト駆動の変換でソース映像を再レンダリングします——大気の変化・スタイル変換・環境変更——元の空間レイアウトとカメラモーションをそのまま維持します。OpenClaw agentはRunAPI経由でチャットと同じAPIキーを使って呼び出します。