Luma Ray 3.2 — Video to Video

Luma Ray 3.2 — Video to Video.

Result & Pricing

Video output — your generated video will appear here.

Your video will appear here

Choose your inputs and customize your settings.

Model pricing (tax excluded) per billed second

Specification	Webot INR
540p	₹17.25
720p	₹25.88
1080p	₹51.76

Calculate credits in the input panel for your selected settings.

Prices, estimates and credit deductions exclude tax. Any applicable tax is charged only when you buy plans or credits.

HDR rate: ×2. HDR with EXR rate: ×3. Prices are converted to INR. Credits use your current plan rate.

Prices shown are estimates, not final charges. Final billing details will be available in Reports after generation is complete.

API

WEBOT API · Video to Video

Generate from your server with your WEBOT account credits.

API Keys OpenAPI JSON

Use your 120-character WEBOT customer key (a–z, A–Z, 0–9). Send Authorization: Bearer YOUR_KEY. Keys are secrets: call from a server, never from public frontend code. Results come from verified webhooks and remain saved if your stream disconnects.

1. Configure your server

WEBOT_BASE_URL=https://webot.online
WEBOT_API_KEY=<your-server-side-WEBOT-key>

This base URL is resolved from verified domain mappings and your direct creator reseller. Forwarded Host headers are not trusted. New custom reseller domains need DNS, TLS and platform verification before activation.

2. Quote, then generate

Method	Endpoint	Purpose
POST	`https://webot.online/api/v1/models/luma_agent_ray_v3_2_video_to_video/quote`	Validate input and calculate credits (no deduction).
POST	`https://webot.online/api/v1/models/luma_agent_ray_v3_2_video_to_video/requests`	Reserve quoted credits and queue an asynchronous job.
GET	`https://webot.online/api/v1/models/luma_agent_ray_v3_2_video_to_video/requests/{request_id}/result`	Read your saved result: 202 pending, 200 terminal.
GET	`https://webot.online/api/v1/models/luma_agent_ray_v3_2_video_to_video/requests/{request_id}/events`	Authenticated SSE: generation / terminal events.

Send JSON {"input":{…}} to quote. Send the same input plus integer quoted_credits to generate, with Authorization: Bearer … and Idempotency-Key. Use a unique 16–128 character key per new job; persist it and reuse the same key and input on any uncertain response. Never retry with a new key: that creates a second chargeable job.

Credits are reserved only after validation and a durable request is saved. A changed quote or insufficient balance returns 409. Credits exclude purchase taxes. The quoted amount is an initial reservation. After generation, the final charge replaces it using confirmed usage. Any verified unused allocation becomes available automatically; additional usage may require more credits. Missing billing stays pending, including for failed jobs.

3. Input example

Save this as input.json. Replace sample prompts, files and media URLs with your own. Schemas do not guarantee provider acceptance of the content.

{
    "prompt": "Audit sample text",
    "video_url": "https://example.com/video.mp4",
    "hdr": false,
    "duration": "5s",
    "exr_export": false,
    "auto_controls": false,
    "resolution": "540p"
}

4. Language examples

Server-side language

# Save the model's example input as input.json, then replace prompts/media URLs.
# Requires curl and jq. Store NONCE once for this job; reuse it on any retry.
export NONCE="$(openssl rand -hex 16)"
BASE="${WEBOT_BASE_URL%/}"
jq -n --slurpfile input input.json '{input:$input[0]}' > quote-body.json
curl --fail-with-body -sS "$BASE/api/v1/models/luma_agent_ray_v3_2_video_to_video/quote" \
  -H "Authorization: Bearer $WEBOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @quote-body.json > quote.json
CREDITS=$(jq -er '.quote.credits_consumed' quote.json)
jq --argjson credits "$CREDITS" '. + {quoted_credits:$credits}' quote-body.json > request-body.json
curl --fail-with-body -sS "$BASE/api/v1/models/luma_agent_ray_v3_2_video_to_video/requests" \
  -H "Authorization: Bearer $WEBOT_API_KEY" -H "Idempotency-Key: $NONCE" \
  -H 'Content-Type: application/json' --data-binary @request-body.json > job.json
# Subscribe; after a nonterminal disconnect, reconnect this SAME URL.
curl --fail-with-body -N "$(jq -er '.events_url' job.json)" -H "Authorization: Bearer $WEBOT_API_KEY"
# Read saved output after terminal notification (never call provider status/results).
curl --fail-with-body -sS "$(jq -er '.result_url' job.json)" -H "Authorization: Bearer $WEBOT_API_KEY"

// Node.js 18+. Save your customized input in input.json.
import { readFileSync } from 'node:fs';
import { randomUUID } from 'node:crypto';
const base = process.env.WEBOT_BASE_URL.replace(/\/$/, '');
const key = process.env.WEBOT_API_KEY;
const input = JSON.parse(readFileSync('input.json', 'utf8'));
const nonce = process.env.WEBOT_JOB_NONCE || randomUUID(); // Persist before submission.
async function post(path, body, nonce) {
  const response = await fetch(base + path, {method:'POST', headers:{
    Authorization:`Bearer ${key}`, 'Content-Type':'application/json',
    ...(nonce ? {'Idempotency-Key':nonce} : {})}, body:JSON.stringify(body)});
  const json = await response.json();
  if (!response.ok) throw new Error(JSON.stringify(json));
  return json;
}
const {quote} = await post('/api/v1/models/luma_agent_ray_v3_2_video_to_video/quote', {input});
const job = await post('/api/v1/models/luma_agent_ray_v3_2_video_to_video/requests', {input, quoted_credits:quote.credits_consumed}, nonce);
console.log(job); // Stable WEBOT request_id, events_url, result_url.
// Stream saved webhook state. Reconnect ONLY the event stream, not the generation.
while (!job.terminal || job.financial_pending) {
  const stream = await fetch(job.events_url, {headers:{Authorization:`Bearer ${key}`}});
  if (!stream.ok) throw new Error(`Event stream HTTP ${stream.status}`);
  let buffer = '';
  for await (const chunk of stream.body.pipeThrough(new TextDecoderStream())) {
    buffer += chunk;
    let end;
    while ((end = buffer.indexOf('\n\n')) !== -1) {
      const event = buffer.slice(0, end); buffer = buffer.slice(end + 2);
      const data = event.split('\n').find(line => line.startsWith('data: '));
      if (!data) continue;
      const state = JSON.parse(data.slice(6));
      if (state.error && !state.status) throw new Error(JSON.stringify(state.error));
      if (state.terminal && !state.financial_pending) { console.log(state.output ?? state.error); process.exit(0); }
    }
  }
  await new Promise(resolve => setTimeout(resolve, 1500));
}
console.log(job.output ?? job.error);

// Node.js 18+. Save your customized input in input.json.
import { readFileSync } from 'node:fs';
import { randomUUID } from 'node:crypto';
const base = process.env.WEBOT_BASE_URL!.replace(/\/$/, '');
const key = process.env.WEBOT_API_KEY!;
const input = JSON.parse(readFileSync('input.json', 'utf8'));
const nonce = process.env.WEBOT_JOB_NONCE || randomUUID(); // Persist before submission.
async function post(path: string, body: unknown, nonce?: string) {
  const response = await fetch(base + path, {method:'POST', headers:{
    Authorization:`Bearer ${key}`, 'Content-Type':'application/json',
    ...(nonce ? {'Idempotency-Key':nonce} : {})}, body:JSON.stringify(body)});
  const json = await response.json();
  if (!response.ok) throw new Error(JSON.stringify(json));
  return json;
}
const {quote} = await post('/api/v1/models/luma_agent_ray_v3_2_video_to_video/quote', {input});
const job = await post('/api/v1/models/luma_agent_ray_v3_2_video_to_video/requests', {input, quoted_credits:quote.credits_consumed}, nonce);
console.log(job); // Stable WEBOT request_id, events_url, result_url.
// Stream saved webhook state. Reconnect ONLY the event stream, not the generation.
while (!job.terminal || job.financial_pending) {
  const stream = await fetch(job.events_url, {headers:{Authorization:`Bearer ${key}`}});
  if (!stream.ok) throw new Error(`Event stream HTTP ${stream.status}`);
  let buffer = '';
  for await (const chunk of stream.body.pipeThrough(new TextDecoderStream())) {
    buffer += chunk;
    let end;
    while ((end = buffer.indexOf('\n\n')) !== -1) {
      const event = buffer.slice(0, end); buffer = buffer.slice(end + 2);
      const data = event.split('\n').find(line => line.startsWith('data: '));
      if (!data) continue;
      const state = JSON.parse(data.slice(6));
      if (state.error && !state.status) throw new Error(JSON.stringify(state.error));
      if (state.terminal && !state.financial_pending) { console.log(state.output ?? state.error); process.exit(0); }
    }
  }
  await new Promise(resolve => setTimeout(resolve, 1500));
}
console.log(job.output ?? job.error);

# Python 3.9+, pip install requests
import json, os, time, uuid, requests
base = os.environ['WEBOT_BASE_URL'].rstrip('/')
headers = {'Authorization': 'Bearer ' + os.environ['WEBOT_API_KEY']}
with open('input.json', encoding='utf-8') as file:
    input_data = json.load(file)
nonce = os.environ.get('WEBOT_JOB_NONCE') or str(uuid.uuid4()) # Persist before submitting.
def post(path, body, extra=None):
    response = requests.post(base + path, headers={**headers, **(extra or {})}, json=body, timeout=180)
    response.raise_for_status()
    return response.json()
quote = post('/api/v1/models/luma_agent_ray_v3_2_video_to_video/quote', {'input': input_data})['quote']
job = post('/api/v1/models/luma_agent_ray_v3_2_video_to_video/requests', {'input': input_data, 'quoted_credits': quote['credits_consumed']}, {'Idempotency-Key': nonce})
state = job
while not state['terminal'] or state.get('financial_pending', False):
    # Reconnect while nonterminal; this reads WEBOT's database, never a provider status API.
    with requests.get(job['events_url'], headers=headers, stream=True, timeout=(10, 40)) as stream:
        stream.raise_for_status()
        for line in stream.iter_lines(decode_unicode=True):
            if line and line.startswith('data: '):
                state = json.loads(line[6:])
                if 'status' not in state: raise RuntimeError(state)
                if state['terminal'] and not state.get('financial_pending', False): break
    if not state['terminal'] or state.get('financial_pending', False): time.sleep(1.5)
print(state['output'] if state['status'] == 'completed' else state['error'])

<?php // PHP 8.1+ with cURL
$base = rtrim(getenv('WEBOT_BASE_URL'), '/');
$input = json_decode(file_get_contents('input.json'), false, 64, JSON_THROW_ON_ERROR);
$nonce = getenv('WEBOT_JOB_NONCE') ?: bin2hex(random_bytes(16)); // Persist this before submission.
function post(string $path, array $body, ?string $nonce = null): array {
    global $base;
    $headers = ['Authorization: Bearer '.getenv('WEBOT_API_KEY'), 'Content-Type: application/json'];
    if ($nonce) $headers[] = 'Idempotency-Key: '.$nonce;
    $ch = curl_init($base.$path);
    curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER=>true, CURLOPT_POST=>true,
        CURLOPT_TIMEOUT=>180, CURLOPT_HTTPHEADER=>$headers,
        CURLOPT_POSTFIELDS=>json_encode($body, JSON_THROW_ON_ERROR)]);
    $raw = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch);
    if ($raw === false || $status < 200 || $status >= 300) throw new RuntimeException('WEBOT HTTP '.$status);
    return json_decode($raw, true, 64, JSON_THROW_ON_ERROR);
}
$quote = post('/api/v1/models/luma_agent_ray_v3_2_video_to_video/quote', ['input'=>$input])['quote'];
$job = post('/api/v1/models/luma_agent_ray_v3_2_video_to_video/requests', ['input'=>$input, 'quoted_credits'=>$quote['credits_consumed']], $nonce);
echo json_encode($job, JSON_PRETTY_PRINT); // Connect to events_url with the same Bearer header.

// Go 1.20+; save as main.go.
package main
import ("bytes"; "encoding/json"; "fmt"; "io"; "net/http"; "os"; "strings"; "time"; "crypto/rand"; "encoding/hex")
func main() {
    base := strings.TrimRight(os.Getenv("WEBOT_BASE_URL"), "/")
    raw, err := os.ReadFile("input.json"); if err != nil { panic(err) }
    nonce := os.Getenv("WEBOT_JOB_NONCE")
    if nonce == "" { b := make([]byte,16); if _,err:=rand.Read(b);err!=nil {panic(err)}; nonce=hex.EncodeToString(b) }
    // Persist nonce before the submission; reuse on ambiguous responses.
    client := &http.Client{Timeout:180*time.Second}
    post := func(path string, body any, id string) map[string]any {
        data, err := json.Marshal(body); if err != nil {panic(err)}
        req, err := http.NewRequest("POST",base+path,bytes.NewReader(data)); if err!=nil {panic(err)}
        req.Header.Set("Authorization","Bearer "+os.Getenv("WEBOT_API_KEY")); req.Header.Set("Content-Type","application/json")
        if id!="" {req.Header.Set("Idempotency-Key",id)}
        res,err:=client.Do(req); if err!=nil {panic(err)}; defer res.Body.Close()
        data,err=io.ReadAll(res.Body); if err!=nil {panic(err)}
        if res.StatusCode<200||res.StatusCode>=300 {panic(string(data))}
        var result map[string]any; if err=json.Unmarshal(data,&result);err!=nil {panic(err)}; return result
    }
    input:=json.RawMessage(raw)
    quote:=post("/api/v1/models/luma_agent_ray_v3_2_video_to_video/quote",map[string]any{"input":input},"")["quote"].(map[string]any)
    job:=post("/api/v1/models/luma_agent_ray_v3_2_video_to_video/requests",map[string]any{"input":input,"quoted_credits":quote["credits_consumed"]},nonce)
    fmt.Println(job) // Stream events_url with the same Authorization header.
}

// Java 11+, Jackson databind dependency; class Main in Main.java.
import java.net.URI;
import java.net.http.*;
import java.nio.file.*;
import java.time.Duration;
import java.util.UUID;
import com.fasterxml.jackson.databind.*;
import com.fasterxml.jackson.databind.node.ObjectNode;
public class Main {
  static final ObjectMapper json = new ObjectMapper();
  static final HttpClient client = HttpClient.newHttpClient();
  static final String base = System.getenv("WEBOT_BASE_URL").replaceAll("/$", "");
  static JsonNode post(String path, JsonNode body, String nonce) throws Exception {
    var b = HttpRequest.newBuilder(URI.create(base+path)).timeout(Duration.ofSeconds(180))
      .header("Authorization","Bearer "+System.getenv("WEBOT_API_KEY")).header("Content-Type","application/json")
      .POST(HttpRequest.BodyPublishers.ofString(json.writeValueAsString(body)));
    if(nonce!=null)b.header("Idempotency-Key",nonce);
    var r=client.send(b.build(),HttpResponse.BodyHandlers.ofString());
    if(r.statusCode()<200||r.statusCode()>=300)throw new IllegalStateException(r.body());
    return json.readTree(r.body());
  }
  public static void main(String[] args) throws Exception {
    var input=json.readTree(Files.readString(Path.of("input.json")));
    ObjectNode body=json.createObjectNode();body.set("input",input);
    var quote=post("/api/v1/models/luma_agent_ray_v3_2_video_to_video/quote",body,null).get("quote");
    body.put("quoted_credits",quote.get("credits_consumed").asInt());
    String nonce=System.getenv("WEBOT_JOB_NONCE");if(nonce==null)nonce=UUID.randomUUID().toString(); // Persist before POST.
    var job=post("/api/v1/models/luma_agent_ray_v3_2_video_to_video/requests",body,nonce);System.out.println(job);
    // Subscribe to job.events_url with Authorization; use BodyHandlers.ofLines().
  }
}

// .NET 8 console app, top-level statements.
using System.Net.Http;
using System.Text;
using System.Text.Json.Nodes;
var client = new HttpClient { Timeout = TimeSpan.FromSeconds(180) };
var root = Environment.GetEnvironmentVariable("WEBOT_BASE_URL")!.TrimEnd('/');
var key = Environment.GetEnvironmentVariable("WEBOT_API_KEY");
async Task<JsonNode> Post(string path, JsonNode body, string? nonce = null) {
    using var req = new HttpRequestMessage(HttpMethod.Post, root + path);
    req.Headers.Add("Authorization", "Bearer " + key);
    if (nonce != null) req.Headers.Add("Idempotency-Key", nonce);
    req.Content = new StringContent(body.ToJsonString(), Encoding.UTF8, "application/json");
    using var res = await client.SendAsync(req);
    var raw = await res.Content.ReadAsStringAsync();res.EnsureSuccessStatusCode();
    return JsonNode.Parse(raw)!;
}
var input = JsonNode.Parse(await File.ReadAllTextAsync("input.json"));
var body = new JsonObject { ["input"] = input };
var quote = await Post("/api/v1/models/luma_agent_ray_v3_2_video_to_video/quote", body);
body["quoted_credits"] = quote["quote"]!["credits_consumed"]!.GetValue<int>();
var nonce = Environment.GetEnvironmentVariable("WEBOT_JOB_NONCE") ?? Guid.NewGuid().ToString(); // Persist before submitting.
var job = await Post("/api/v1/models/luma_agent_ray_v3_2_video_to_video/requests", body, nonce);
Console.WriteLine(job); // Subscribe to events_url with the same Bearer header and ResponseHeadersRead.

# Ruby 3+, standard library only.
require 'net/http'
require 'json'
require 'securerandom'
base = ENV.fetch('WEBOT_BASE_URL').sub(%r{/$}, '')
post = lambda do |path, body, nonce = nil|
  uri = URI(base + path)
  req = Net::HTTP::Post.new(uri)
  req['Authorization'] = 'Bearer ' + ENV.fetch('WEBOT_API_KEY')
  req['Content-Type'] = 'application/json'
  req['Idempotency-Key'] = nonce if nonce
  req.body = JSON.generate(body)
  res = Net::HTTP.start(uri.host, uri.port, use_ssl: true, read_timeout: 180) { |http| http.request(req) }
  raise res.body unless res.is_a?(Net::HTTPSuccess)
  JSON.parse(res.body)
end
input = JSON.parse(File.read('input.json'))
quote = post.call('/api/v1/models/luma_agent_ray_v3_2_video_to_video/quote', {'input' => input})['quote']
nonce = ENV['WEBOT_JOB_NONCE'] || SecureRandom.uuid # Persist this before submission.
job = post.call('/api/v1/models/luma_agent_ray_v3_2_video_to_video/requests', {'input' => input, 'quoted_credits' => quote['credits_consumed']}, nonce)
puts JSON.pretty_generate(job) # Subscribe to events_url with the same Authorization header.

// Swift 5.9 server-side/CLI only. Do not embed customer keys in shipped apps.
import Foundation
#if canImport(FoundationNetworking)
import FoundationNetworking
#endif
@main struct Main {
 static func main() async throws {
  let env=ProcessInfo.processInfo.environment
  let base=env["WEBOT_BASE_URL"]!.trimmingCharacters(in: CharacterSet(charactersIn:"/"))
  let input=try JSONSerialization.jsonObject(with: Data(contentsOf:URL(fileURLWithPath:"input.json")))
  func post(_ path:String,_ body:[String:Any],_ nonce:String?=nil) async throws -> [String:Any] {
   var req=URLRequest(url:URL(string:base+path)!);req.httpMethod="POST";req.timeoutInterval=180
   req.setValue("Bearer "+env["WEBOT_API_KEY"]!,forHTTPHeaderField:"Authorization")
   req.setValue("application/json",forHTTPHeaderField:"Content-Type")
   if let nonce {req.setValue(nonce,forHTTPHeaderField:"Idempotency-Key")}
   req.httpBody=try JSONSerialization.data(withJSONObject:body)
   let (data,res)=try await URLSession.shared.data(for:req)
   guard let http=res as? HTTPURLResponse,(200..<300).contains(http.statusCode) else {throw NSError(domain:"WEBOT",code:1)}
   return try JSONSerialization.jsonObject(with:data) as! [String:Any]
  }
  let quote=try await post("/api/v1/models/luma_agent_ray_v3_2_video_to_video/quote",["input":input])["quote"] as! [String:Any]
  let nonce=env["WEBOT_JOB_NONCE"] ?? UUID().uuidString // Persist before submission.
  let job=try await post("/api/v1/models/luma_agent_ray_v3_2_video_to_video/requests",["input":input,"quoted_credits":quote["credits_consumed"]!],nonce)
  print(job) // Subscribe to events_url with the same Authorization header.
 }
}

// Server-side Kotlin/JVM 17+, Gradle dependencies: OkHttp 4.12, org.json 20240303.
import okhttp3.*
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.RequestBody.Companion.toRequestBody
import org.json.JSONObject
import java.io.File
import java.util.UUID
import java.util.concurrent.TimeUnit
fun main() {
 val base=System.getenv("WEBOT_BASE_URL").trimEnd('/')
 val client=OkHttpClient.Builder().readTimeout(180,TimeUnit.SECONDS).build()
 fun post(path:String,body:JSONObject,nonce:String?=null):JSONObject {
  val b=Request.Builder().url(base+path).header("Authorization","Bearer "+System.getenv("WEBOT_API_KEY"))
   .post(body.toString().toRequestBody("application/json".toMediaType()))
  if(nonce!=null)b.header("Idempotency-Key",nonce)
  return client.newCall(b.build()).execute().use {res ->
   val raw=res.body!!.string();check(res.isSuccessful){raw};JSONObject(raw)
  }
 }
 val body=JSONObject().put("input",JSONObject(File("input.json").readText()))
 val quote=post("/api/v1/models/luma_agent_ray_v3_2_video_to_video/quote",body).getJSONObject("quote")
 body.put("quoted_credits",quote.getInt("credits_consumed"))
 val nonce=System.getenv("WEBOT_JOB_NONCE") ?: UUID.randomUUID().toString() // Persist before submission.
 val job=post("/api/v1/models/luma_agent_ray_v3_2_video_to_video/requests",body,nonce)
 println(job) // Subscribe to events_url with the same Authorization header.
}

5. Receive all results

The response includes a stable WEBOT request_id, events_url and result_url. Subscribe with a Bearer-authenticated HTTP stream. Nonterminal streams end after 25 seconds; reconnect to the same URL after at least 1.5 seconds. Current saved state is replayed immediately, including completion that happened while disconnected. A terminal event contains the result envelope. The JSON terminal flag describes generation completion. Keep reconnecting while financial_pending is true; stop after the terminal event confirms financial settlement. Never poll provider status/results. Native browser EventSource cannot send a Bearer header; keep the key on your server.

Completed output contains the full model result, including every generated media/document item, not just the first URL. Failed output is null with error and refund_state. Results are strictly limited to the key owner, including on reseller domains. Model-independent aliases: /api/v1/requests/{request_id}/result and /events. Revoking a key blocks subsequent reads and streams; saved results remain accessible with another valid key of the same account.

6. Schemas and parameter defaults

Required fields are marked with *. Required text must contain non-whitespace content. Defaults apply when an optional parameter is omitted; null, false, 0 and an empty array are distinct values. “No documented default” means WEBOT does not invent one. Examples are sample inputs, not defaults. WEBOT generation constraints can require an explicit value even when the provider publishes an automatic default.

Input schema · fields, constraints and defaults

Parameter	Type	Required	Default when omitted	Description / constraints
`start_image_url`	string \| null	No	`No documented default`	Optional URL of an image to use as the edited video's first frame — e.g. a restyled version of the source's opening frame to steer the look of the edit. Leave unset to let the model derive the first frame from the source video.
`hdr`	boolean	No	`false`	Generate an HDR-encoded MP4. Requires HDR access on the account and a resolution of 720p or 1080p.
`video_url`	string	Yes *	`No documented default`	URL of the source video to edit. minLength: 1
`edit_strength`	string \| null	No	`No documented default`	How closely the edit preserves the source video. 'adhere_' stays closest to the source, 'flex_' is balanced, and 'reimagine_*' diverges most. Leave unset to use Luma's default. Cannot be combined with auto_controls.
`duration`	string	No	`"5s"`	Duration of the edited video. enum: ["5s","10s"]
`exr_export`	boolean	No	`false`	Also export an EXR file alongside the MP4. Requires hdr=true and HDR access.
`keyframe_indexes`	array \| null	No	`No documented default`	Source-video frame positions where each keyframes[i] is anchored. Non-negative, unique, and the same length as keyframes.
`controls`	object \| null	No	`No documented default`	Per-signal conditioning controls (pose, depth, normals, trajectory, face) for finer control than edit_strength. Cannot be combined with auto_controls.
`controls.variant0.normals`	object \| null	No	`No documented default`	Surface-normals conditioning.
`controls.variant0.normals.variant0.enabled`	boolean	No	`true`	Enable surface-normals conditioning for the edit.
`controls.variant0.normals.variant0.augmentation`	number \| null	No	`No documented default`	Surface-normals augmentation. Higher values allow more reinterpretation of surface geometry. Leave unset for the default.
`controls.variant0.trajectory`	object \| null	No	`No documented default`	Motion-trajectory conditioning.
`controls.variant0.trajectory.variant0.enabled`	boolean	No	`true`	Enable motion-trajectory conditioning for the edit.
`controls.variant0.trajectory.variant0.sparsity`	number \| null	No	`No documented default`	Motion-trajectory sparsity. Higher values use fewer motion anchors. Leave unset for the default.
`controls.variant0.face`	object \| null	No	`No documented default`	Face-identity conditioning.
`controls.variant0.face.variant0.enabled`	boolean	No	`true`	Enable face-identity conditioning for the edit.
`controls.variant0.depth`	object \| null	No	`No documented default`	Depth / scene-geometry conditioning.
`controls.variant0.depth.variant0.blur`	number \| null	No	`No documented default`	Depth blur. Higher values allow more geometric freedom. Leave unset for the default.
`controls.variant0.depth.variant0.enabled`	boolean	No	`true`	Enable depth / scene-geometry conditioning for the edit.
`controls.variant0.pose`	object \| null	No	`No documented default`	Pose / skeleton conditioning.
`controls.variant0.pose.variant0.enabled`	boolean	No	`true`	Enable pose / skeleton conditioning for the edit.
`controls.variant0.pose.variant0.strength`	string \| null	No	`No documented default`	Pose conditioning precision. 'precise' follows the source pose tightly; 'coarse' allows more freedom. Leave unset for the default.
`user`	string \| null	No	`No documented default`	Optional opaque identifier for the end user making the request. Used only for abuse attribution; never interpreted by fal.
`prompt`	string	Yes *	`No documented default`	Text prompt describing how to edit the source video. minLength: 1 · maxLength: 6000
`auto_controls`	boolean	No	`false`	Let the model derive the edit conditioning schedule from the source video. Cannot be combined with edit_strength.
`resolution`	string	No	`"540p"`	Resolution of the edited video. Higher resolutions cost more. enum: ["540p","720p","1080p"]
`keyframes`	array \| null	No	`No documented default`	Multi-keyframe edit guide frames: up to 64 image URLs pinned at the source-frame positions given by keyframe_indexes. Mutually exclusive with start_image_url. Provide keyframes and keyframe_indexes together (same length).
`enable_safety_checker`	boolean	No	`true`	Authorized callers may set false to request relaxed screening.

{
    "properties": {
        "start_image_url": {
            "anyOf": [
                {
                    "type": "string"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Start Image Url",
            "description": "Optional URL of an image to use as the edited video's first frame \u2014 e.g. a restyled version of the source's opening frame to steer the look of the edit. Leave unset to let the model derive the first frame from the source video.",
            "examples": [
                "https://storage.googleapis.com/falserverless/gallery/example_inputs_liuyifei.png"
            ]
        },
        "hdr": {
            "type": "boolean",
            "title": "Hdr",
            "description": "Generate an HDR-encoded MP4. Requires HDR access on the account and a resolution of 720p or 1080p.",
            "default": false
        },
        "video_url": {
            "title": "Video Url",
            "description": "URL of the source video to edit.",
            "examples": [
                "https://storage.googleapis.com/falserverless/example_inputs/birefnet-video-input.mp4"
            ],
            "minLength": 1,
            "type": "string"
        },
        "edit_strength": {
            "anyOf": [
                {
                    "enum": [
                        "adhere_1",
                        "adhere_2",
                        "adhere_3",
                        "flex_1",
                        "flex_2",
                        "flex_3",
                        "reimagine_1",
                        "reimagine_2",
                        "reimagine_3"
                    ],
                    "type": "string"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Edit Strength",
            "description": "How closely the edit preserves the source video. 'adhere_*' stays closest to the source, 'flex_*' is balanced, and 'reimagine_*' diverges most. Leave unset to use Luma's default. Cannot be combined with auto_controls."
        },
        "duration": {
            "type": "string",
            "title": "Duration",
            "enum": [
                "5s",
                "10s"
            ],
            "description": "Duration of the edited video.",
            "default": "5s"
        },
        "exr_export": {
            "type": "boolean",
            "title": "Exr Export",
            "description": "Also export an EXR file alongside the MP4. Requires hdr=true and HDR access.",
            "default": false
        },
        "keyframe_indexes": {
            "anyOf": [
                {
                    "maxItems": 64,
                    "minItems": 1,
                    "items": {
                        "type": "integer"
                    },
                    "type": "array"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Keyframe Indexes",
            "description": "Source-video frame positions where each keyframes[i] is anchored. Non-negative, unique, and the same length as keyframes."
        },
        "controls": {
            "anyOf": [
                {
                    "properties": {
                        "normals": {
                            "anyOf": [
                                {
                                    "properties": {
                                        "enabled": {
                                            "type": "boolean",
                                            "title": "Enabled",
                                            "description": "Enable surface-normals conditioning for the edit.",
                                            "default": true
                                        },
                                        "augmentation": {
                                            "anyOf": [
                                                {
                                                    "maximum": 1,
                                                    "minimum": 0,
                                                    "type": "number"
                                                },
                                                {
                                                    "type": "null"
                                                }
                                            ],
                                            "title": "Augmentation",
                                            "description": "Surface-normals augmentation. Higher values allow more reinterpretation of surface geometry. Leave unset for the default."
                                        }
                                    },
                                    "type": "object",
                                    "title": "RayEditNormalsControl",
                                    "additionalProperties": false,
                                    "x-webot-order-properties": [
                                        "enabled",
                                        "augmentation"
                                    ]
                                },
                                {
                                    "type": "null"
                                }
                            ],
                            "description": "Surface-normals conditioning."
                        },
                        "trajectory": {
                            "anyOf": [
                                {
                                    "properties": {
                                        "enabled": {
                                            "type": "boolean",
                                            "title": "Enabled",
                                            "description": "Enable motion-trajectory conditioning for the edit.",
                                            "default": true
                                        },
                                        "sparsity": {
                                            "anyOf": [
                                                {
                                                    "maximum": 1,
                                                    "minimum": 0,
                                                    "type": "number"
                                                },
                                                {
                                                    "type": "null"
                                                }
                                            ],
                                            "title": "Sparsity",
                                            "description": "Motion-trajectory sparsity. Higher values use fewer motion anchors. Leave unset for the default."
                                        }
                                    },
                                    "type": "object",
                                    "title": "RayEditTrajectoryControl",
                                    "additionalProperties": false,
                                    "x-webot-order-properties": [
                                        "enabled",
                                        "sparsity"
                                    ]
                                },
                                {
                                    "type": "null"
                                }
                            ],
                            "description": "Motion-trajectory conditioning."
                        },
                        "face": {
                            "anyOf": [
                                {
                                    "properties": {
                                        "enabled": {
                                            "type": "boolean",
                                            "title": "Enabled",
                                            "description": "Enable face-identity conditioning for the edit.",
                                            "default": true
                                        }
                                    },
                                    "type": "object",
                                    "title": "RayEditFaceControl",
                                    "additionalProperties": false,
                                    "x-webot-order-properties": [
                                        "enabled"
                                    ]
                                },
                                {
                                    "type": "null"
                                }
                            ],
                            "description": "Face-identity conditioning."
                        },
                        "depth": {
                            "anyOf": [
                                {
                                    "properties": {
                                        "blur": {
                                            "anyOf": [
                                                {
                                                    "maximum": 1,
                                                    "minimum": 0,
                                                    "type": "number"
                                                },
                                                {
                                                    "type": "null"
                                                }
                                            ],
                                            "title": "Blur",
                                            "description": "Depth blur. Higher values allow more geometric freedom. Leave unset for the default."
                                        },
                                        "enabled": {
                                            "type": "boolean",
                                            "title": "Enabled",
                                            "description": "Enable depth / scene-geometry conditioning for the edit.",
                                            "default": true
                                        }
                                    },
                                    "type": "object",
                                    "title": "RayEditDepthControl",
                                    "additionalProperties": false,
                                    "x-webot-order-properties": [
                                        "enabled",
                                        "blur"
                                    ]
                                },
                                {
                                    "type": "null"
                                }
                            ],
                            "description": "Depth / scene-geometry conditioning."
                        },
                        "pose": {
                            "anyOf": [
                                {
                                    "properties": {
                                        "enabled": {
                                            "type": "boolean",
                                            "title": "Enabled",
                                            "description": "Enable pose / skeleton conditioning for the edit.",
                                            "default": true
                                        },
                                        "strength": {
                                            "anyOf": [
                                                {
                                                    "enum": [
                                                        "precise",
                                                        "coarse"
                                                    ],
                                                    "type": "string"
                                                },
                                                {
                                                    "type": "null"
                                                }
                                            ],
                                            "title": "Strength",
                                            "description": "Pose conditioning precision. 'precise' follows the source pose tightly; 'coarse' allows more freedom. Leave unset for the default."
                                        }
                                    },
                                    "type": "object",
                                    "title": "RayEditPoseControl",
                                    "additionalProperties": false,
                                    "x-webot-order-properties": [
                                        "enabled",
                                        "strength"
                                    ]
                                },
                                {
                                    "type": "null"
                                }
                            ],
                            "description": "Pose / skeleton conditioning."
                        }
                    },
                    "type": "object",
                    "title": "RayEditControls",
                    "additionalProperties": false,
                    "description": "Per-signal conditioning controls for ray-3.2 video editing.\n\nEach signal is optional; include only the signals you want to tune. Cannot\nbe combined with auto_controls. Mirrors the Luma Agents ``video.edit.controls``\nobject \u2014 see https://docs.agents.lumalabs.ai/api/resources/generations.",
                    "x-webot-order-properties": [
                        "pose",
                        "depth",
                        "normals",
                        "trajectory",
                        "face"
                    ]
                },
                {
                    "type": "null"
                }
            ],
            "description": "Per-signal conditioning controls (pose, depth, normals, trajectory, face) for finer control than edit_strength. Cannot be combined with auto_controls."
        },
        "user": {
            "anyOf": [
                {
                    "type": "string"
                },
                {
                    "type": "null"
                }
            ],
            "title": "User",
            "description": "Optional opaque identifier for the end user making the request. Used only for abuse attribution; never interpreted by fal."
        },
        "prompt": {
            "title": "Prompt",
            "maxLength": 6000,
            "examples": [
                "Restyle the footage as a hand-painted watercolor animation with soft pastel colors."
            ],
            "description": "Text prompt describing how to edit the source video.",
            "minLength": 1,
            "type": "string"
        },
        "auto_controls": {
            "type": "boolean",
            "title": "Auto Controls",
            "description": "Let the model derive the edit conditioning schedule from the source video. Cannot be combined with edit_strength.",
            "default": false
        },
        "resolution": {
            "type": "string",
            "title": "Resolution",
            "enum": [
                "540p",
                "720p",
                "1080p"
            ],
            "description": "Resolution of the edited video. Higher resolutions cost more.",
            "default": "540p"
        },
        "keyframes": {
            "anyOf": [
                {
                    "maxItems": 64,
                    "minItems": 1,
                    "items": {
                        "type": "string"
                    },
                    "type": "array"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Keyframes",
            "description": "Multi-keyframe edit guide frames: up to 64 image URLs pinned at the source-frame positions given by keyframe_indexes. Mutually exclusive with start_image_url. Provide keyframes and keyframe_indexes together (same length)."
        },
        "enable_safety_checker": {
            "description": "Authorized callers may set false to request relaxed screening.",
            "default": true,
            "type": "boolean",
            "title": "Enable Safety Checker"
        }
    },
    "required": [
        "prompt",
        "video_url"
    ],
    "title": "RayVideoToVideoRequest",
    "additionalProperties": false,
    "type": "object",
    "x-webot-order-properties": [
        "prompt",
        "video_url",
        "user",
        "start_image_url",
        "resolution",
        "duration",
        "edit_strength",
        "auto_controls",
        "hdr",
        "exr_export",
        "controls",
        "keyframes",
        "keyframe_indexes",
        "enable_safety_checker"
    ],
    "allOf": [
        {
            "not": {
                "allOf": [
                    {
                        "required": [
                            "auto_controls"
                        ],
                        "properties": {
                            "auto_controls": {
                                "type": "boolean",
                                "const": true
                            }
                        }
                    },
                    {
                        "required": [
                            "edit_strength"
                        ],
                        "properties": {
                            "edit_strength": {
                                "type": "string",
                                "minLength": 1
                            }
                        }
                    }
                ]
            },
            "x-webot-message": "Choose auto controls or edit strength, not both."
        },
        {
            "not": {
                "allOf": [
                    {
                        "required": [
                            "auto_controls"
                        ],
                        "properties": {
                            "auto_controls": {
                                "type": "boolean",
                                "const": true
                            }
                        }
                    },
                    {
                        "required": [
                            "controls"
                        ],
                        "properties": {
                            "controls": {
                                "not": {
                                    "type": "null"
                                }
                            }
                        }
                    }
                ]
            },
            "x-webot-message": "Choose auto controls or controls, not both."
        }
    ],
    "x-webot-cross-rules": [
        {
            "kind": "same_length",
            "fields": [
                "keyframes",
                "keyframe_indexes"
            ],
            "message": "Provide matching numbers of keyframes and keyframe indexes."
        },
        {
            "kind": "unique",
            "fields": [
                "keyframe_indexes[]"
            ],
            "message": "Each keyframe needs a unique frame index."
        }
    ]
}

Output (inside result.output) schema · fields, constraints and defaults

Parameter	Type	Required	Default when omitted	Description / constraints
`exr_file`	object \| null	No	`No documented default`	The generated EXR sidecar when exr_export is true. This may be a single EXR file or a ZIP package depending on Luma's export shape.
`exr_file.variant0.content_type`	string \| null	No	`No documented default`	The mime type of the file.
`exr_file.variant0.url`	string	Yes *	`No documented default`	The URL where the file can be downloaded from.
`exr_file.variant0.file_size`	integer \| null	No	`No documented default`	The size of the file in bytes.
`exr_file.variant0.file_name`	string \| null	No	`No documented default`	The name of the file. It will be auto-generated if not provided.
`video`	object	Yes *	`No documented default`	The generated video.
`video.content_type`	string \| null	No	`No documented default`	The mime type of the file.
`video.url`	string	Yes *	`No documented default`	The URL where the file can be downloaded from.
`video.file_size`	integer \| null	No	`No documented default`	The size of the file in bytes.
`video.file_name`	string \| null	No	`No documented default`	The name of the file. It will be auto-generated if not provided.

{
    "properties": {
        "exr_file": {
            "anyOf": [
                {
                    "properties": {
                        "content_type": {
                            "anyOf": [
                                {
                                    "type": "string"
                                },
                                {
                                    "type": "null"
                                }
                            ],
                            "title": "Content Type",
                            "description": "The mime type of the file.",
                            "examples": [
                                "image/png"
                            ]
                        },
                        "url": {
                            "title": "Url",
                            "description": "The URL where the file can be downloaded from.",
                            "type": "string"
                        },
                        "file_size": {
                            "anyOf": [
                                {
                                    "type": "integer"
                                },
                                {
                                    "type": "null"
                                }
                            ],
                            "title": "File Size",
                            "description": "The size of the file in bytes.",
                            "examples": [
                                4404019
                            ]
                        },
                        "file_name": {
                            "anyOf": [
                                {
                                    "type": "string"
                                },
                                {
                                    "type": "null"
                                }
                            ],
                            "title": "File Name",
                            "description": "The name of the file. It will be auto-generated if not provided.",
                            "examples": [
                                "z9RV14K95DvU.png"
                            ]
                        }
                    },
                    "required": [
                        "url"
                    ],
                    "title": "File",
                    "type": "object",
                    "x-webot-order-properties": [
                        "url",
                        "content_type",
                        "file_name",
                        "file_size"
                    ]
                },
                {
                    "type": "null"
                }
            ],
            "description": "The generated EXR sidecar when exr_export is true. This may be a single EXR file or a ZIP package depending on Luma's export shape."
        },
        "video": {
            "properties": {
                "content_type": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "null"
                        }
                    ],
                    "title": "Content Type",
                    "description": "The mime type of the file.",
                    "examples": [
                        "image/png"
                    ]
                },
                "url": {
                    "title": "Url",
                    "description": "The URL where the file can be downloaded from.",
                    "type": "string"
                },
                "file_size": {
                    "anyOf": [
                        {
                            "type": "integer"
                        },
                        {
                            "type": "null"
                        }
                    ],
                    "title": "File Size",
                    "description": "The size of the file in bytes.",
                    "examples": [
                        4404019
                    ]
                },
                "file_name": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "null"
                        }
                    ],
                    "title": "File Name",
                    "description": "The name of the file. It will be auto-generated if not provided.",
                    "examples": [
                        "z9RV14K95DvU.png"
                    ]
                }
            },
            "required": [
                "url"
            ],
            "title": "File",
            "type": "object",
            "x-webot-order-properties": [
                "url",
                "content_type",
                "file_name",
                "file_size"
            ],
            "description": "The generated video."
        }
    },
    "required": [
        "video"
    ],
    "title": "VideoOutput",
    "type": "object",
    "x-webot-order-properties": [
        "video",
        "exr_file"
    ]
}

Errors and limits

401 invalid/expired/revoked key · 403 key scope or domain mismatch · 404 unavailable model or unowned request · 409 quote changed, balance, concurrency or idempotency conflict · 413 JSON exceeds 2 MB · 415 wrong content type · 422 invalid fields/media · 429 rate limit · 503 temporary/ambiguous submission. Respect Retry-After. Current limits per account: 12 quotes/submissions, 120 result reads and 8 stream connections per minute. One submission preparation at a time per account. Do not automatically regenerate failed jobs.

Your requests

Luma Ray 3.2 - Video to Video · Your account only

Select Requests to load your history.

Request ID	Created at (IST)	Status	Credits used	Refunded	Processing time	Report

Show rows

Your model analytics

Luma Ray 3.2 - Video to Video · Request dates in IST

Select Analytics to load your metrics.

Request counts

Daily requests by their current status

Request outcomes

Completed, failed and pending requests

Credits used

Daily recorded charges before refunds

Processing time

Daily average for completed requests with recorded timing

Processing percentiles

Completed requests only · Time from submission to recorded completion

How to use Luma Ray 3.2 — Video to Video

Start with an existing video and use this model’s editing or transformation tools to change it. The exact kind of change depends on this particular endpoint.

Required inputs

Prompt: Your instructions to the model. Say what you want, include the important details and avoid contradictory directions. For a video, describe the action as well as the scene.
Video Url: The source video or videos. The model needs an accessible file in a supported format. Check length, resolution and audio requirements in the form before submitting.

Workflow

Prepare your source material and fill the required inputs above. Review the supported settings for this model.
Sign in to calculate the credit estimate. Review the estimate before choosing Generate.
Keep this model page open while the request runs. Completed results arrive in the result area; use the available player or download controls to review the output.

When to use this workflow

Apply the transformation described for this model.
Use an existing clip as the starting material.

Key settings

Prompt: Your instructions to the model. Say what you want, include the important details and avoid contradictory directions. For a video, describe the action as well as the scene. Minimum characters: 1. Maximum characters: 6000
Video Url: The source video or videos. The model needs an accessible file in a supported format. Check length, resolution and audio requirements in the form before submitting. Minimum characters: 1
Start Image Url: The picture used to guide the beginning of the video. Choose a frame that clearly establishes the subject and scene. The exact amount of control depends on this model.
Resolution: The amount of detail in the output’s size. For ordinary video, 1080p has more pixels than 720p. Larger sizes can need more processing and larger files; the credit effect depends on this model. A larger output cannot guarantee better source detail. For a 3D or internal grid setting, follow the model’s specific description below. Supported choices: "540p", "720p", "1080p"
Duration: How long the output should last, normally in seconds. A larger value asks for a longer clip, not a sharper one. Longer duration may change the credit estimate. Use only the supported lengths; “auto”, if offered, lets the model decide under its own limits. Supported choices: "5s", "10s"
Edit Strength: How much influence or change is applied to the source. In many editing models, higher strength means a larger change, while lower strength keeps more of the original. Direction and scale can differ between models: check the specific description below before changing it. Supported choices: "adhere_1", "adhere_2", "adhere_3", "flex_1", "flex_2", "flex_3", "reimagine_1", "reimagine_2", "reimagine_3"

Related model workspaces

Alibaba Happy Horse — Edit Video

Alibaba Wan 2.2 — Depth

Alibaba Wan 2.2 — Inpainting

Alibaba Wan 2.2 — Move

Alibaba Wan 2.2 — Outpainting

Alibaba Wan 2.2 — Reframe

Product-video workflow · Video route comparison

Compare more AI models · Explore plans and credits