Vai al contenuto

Luma Ray 3.2 Video to Video

Integra

ID del modello luma/agent/ray/v3.2/video-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/luma/agent/ray/v3.2/video-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Questa richiesta: 0,72 $ 720 crediti API · ≈ 77,27 ₽ Esegui in questa pagina

Ottieni la chiave API
Luma AI Da video a video Lipsync5–10 sfino a 1080p #stylized#transform

Editing video Ray 3.2 che rielabora lo stile di un video sorgente con preset, controlli e fotogrammi chiave per l'intensità dell'editing

Luma AI · Video

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

•obbligatorio 88 / 6000

Istruzioni testuali per modificare il video sorgente.

•obbligatorio video_url
Trascina un file oppure

URL del video da modificare.

duration 5 s

Durata del video dopo la modifica.

resolution predefinito 540p

Risoluzione dell'output dopo la modifica.

Avanzate image · user · edit_strength · auto_controls · enable_safety_checker · keyframes · controls · keyframe_indexes
start_image_url
Trascina un file oppure

Override del primo fotogramma per il video modificato, fornito come URL opzionale di un'immagine; se omesso, il modello ricava il fotogramma dal video sorgente. Ad esempio, fornire un'immagine iniziale rielaborata dal sorgente può guidare l'aspetto della modifica.

ID opaco opzionale che identifica l'utente finale che invia la richiesta.

Impostazione di preservazione del sorgente per le modifiche, disponibile solo quando auto_controls non è usato; l'omissione seleziona il valore predefinito del modello. Dalla maggiore variazione alla massima aderenza, le opzioni sono 'reimagine_*', 'flex_*' per un risultato equilibrato e 'adhere_*'.

Guide di modifica con più fotogrammi chiave fornite come URL di immagini invece di start_image_url. Fornisci i fotogrammi chiave insieme a un array keyframe_indexes della stessa lunghezza per associare ogni immagine alla posizione del fotogramma nel video sorgente; sono consentiti al massimo 64 URL.

Alternativa dettagliata a edit_strength che configura separatamente il condizionamento per posa, profondità, normali, traiettoria e volto. L'uso di questi controlli esclude auto_controls.

Mappatura dei fotogrammi sorgente abbinata uno a uno ai fotogrammi chiave: la voce [i] specifica la posizione dell'ancoraggio per keyframes[i]. I due array devono avere la stessa lunghezza e le posizioni devono essere distinte e non negative.

POST /run/luma/agent/ray/v3.2/video-to-video?wait=20 preventivo → 0,72 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/luma/agent/ray/v3.2/video-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su Luma Ray 3.2 Video to Video

Modifica un `video_url` secondo un `prompt`, con `start_image_url` facoltativo per guidare il primo fotogramma. `edit_strength` offre i livelli adhere, flex e reimagine da 1 a 3, mentre `auto_controls` o un oggetto `controls` forniscono modalità alternative di condizionamento. È possibile ancorare fino a 64 `keyframes` con `keyframe_indexes`. L'output è da 540p a 1080p, di 5s o 10s, con `hdr` e `exr_export` facoltativi.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
promptobbligatorio
Tipostring
≤ 6000 caratteri
Istruzioni testuali per modificare il video sorgente.
video_urlobbligatorio video
Tipourl · video
URL del video da modificare.
userfacoltativo
Tipostring | null
ID opaco opzionale che identifica l'utente finale che invia la richiesta.
start_image_urlfacoltativo image
Tipourl · image
Override del primo fotogramma per il video modificato, fornito come URL opzionale di un'immagine; se omesso, il modello ricava il fotogramma dal video sorgente. Ad esempio, fornire un'immagine iniziale rielaborata dal sorgente può guidare l'aspetto della modifica.
resolutionfacoltativo
Tipoenum
Predefinito540p
540p720p1080p
Risoluzione dell'output dopo la modifica.
durationfacoltativo
Tipoenum
Predefinito5s
5s10s
Durata del video dopo la modifica.
edit_strengthfacoltativo
Tipoenum
adhere_1adhere_2adhere_3flex_1flex_2flex_3reimagine_1reimagine_2reimagine_3
Impostazione di preservazione del sorgente per le modifiche, disponibile solo quando auto_controls non è usato; l'omissione seleziona il valore predefinito del modello. Dalla maggiore variazione alla massima aderenza, le opzioni sono 'reimagine_*', 'flex_*' per un risultato equilibrato e 'adhere_*'.
auto_controlsfacoltativo
Tipoboolean
Predefinitofalse
Condizionamento automatico della modifica: il modello usa il video sorgente per determinare la pianificazione invece di accettare edit_strength insieme a questa opzione.
hdrfacoltativo
Tipoboolean
Predefinitofalse
Codifica HDR per output MP4 a 720p o 1080p, disponibile solo per gli account con accesso HDR.
exr_exportfacoltativo
Tipoboolean
Predefinitofalse
Esportazione EXR aggiuntiva insieme all'MP4, disponibile solo con accesso HDR e hdr=true.
controlsfacoltativo
Tipoobject
Alternativa dettagliata a edit_strength che configura separatamente il condizionamento per posa, profondità, normali, traiettoria e volto. L'uso di questi controlli esclude auto_controls.
controls.posefacoltativo
Tipoobject
Condizionamento basato sulla posa o sullo scheletro.
controls.pose.enabledfacoltativo
Tipoboolean
Predefinitotrue
Attiva o disattiva il condizionamento della posa o dello scheletro durante la modifica.
controls.pose.strengthfacoltativo
Tipoenum
precisecoarse
Selezione della precisione del condizionamento della posa: ometti il valore per mantenere il predefinito, scegli 'coarse' per maggiore libertà oppure usa 'precise' per seguire strettamente la posa sorgente.
controls.depthfacoltativo
Tipoobject
Condizionamento basato sulla profondità o sulla geometria della scena.
controls.depth.enabledfacoltativo
Tipoboolean
Predefinitotrue
Attiva o disattiva il condizionamento della profondità o della geometria della scena durante la modifica.
controls.depth.blurfacoltativo
Tiponumber | null
0 – 1
Impostazione della sfocatura della profondità, lasciata non specificata per mantenere il valore predefinito o aumentata per concedere maggiore libertà alla geometria.
controls.normalsfacoltativo
Tipoobject
Condizionamento basato sulle normali della superficie.
controls.normals.enabledfacoltativo
Tipoboolean
Predefinitotrue
Attiva o disattiva il condizionamento delle normali della superficie durante la modifica.
controls.normals.augmentationfacoltativo
Tiponumber | null
0 – 1
Impostazione dell'aumento delle normali della superficie; ometti il valore per mantenere il predefinito oppure aumentalo per consentire una maggiore reinterpretazione della geometria della superficie.
controls.trajectoryfacoltativo
Tipoobject
Condizionamento basato sulle traiettorie di movimento.
controls.trajectory.enabledfacoltativo
Tipoboolean
Predefinitotrue
Attiva o disattiva il condizionamento della traiettoria di movimento.
controls.trajectory.sparsityfacoltativo
Tiponumber | null
0 – 1
Impostazione della scarsità della traiettoria di movimento; omettila per mantenere il predefinito oppure aumentala per ridurre il numero di ancoraggi di movimento usati.
controls.facefacoltativo
Tipoobject
Condizionamento basato sull'identità facciale.
controls.face.enabledfacoltativo
Tipoboolean
Predefinitotrue
Attiva o disattiva il condizionamento dell'identità facciale durante la modifica.
keyframesfacoltativo
Tipostring[]
≤ 64 elementi
Guide di modifica con più fotogrammi chiave fornite come URL di immagini invece di start_image_url. Fornisci i fotogrammi chiave insieme a un array keyframe_indexes della stessa lunghezza per associare ogni immagine alla posizione del fotogramma nel video sorgente; sono consentiti al massimo 64 URL.
keyframe_indexesfacoltativo
Tipointeger[]
≤ 64 elementi
Mappatura dei fotogrammi sorgente abbinata uno a uno ai fotogrammi chiave: la voce [i] specifica la posizione dell'ancoraggio per keyframes[i]. I due array devono avere la stessa lunghezza e le posizioni devono essere distinte e non negative.
enable_safety_checkerfacoltativo
Tipoboolean
Predefinitotrue
Il controllo può essere allentato impostando false, se il chiamante è autorizzato.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "luma/agent/ray/v3.2/video-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 720,
    "usd": "0.72",
    "charged": 720,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "exr_file": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
video
object {url, content_type, file_name, file_size}Video prodotto dal modello.
exr_file
object {url, content_type, file_name, file_size} | nullFile EXR associato nel formato esportato da Luma: un singolo file EXR o un archivio ZIP. Viene generato quando exr_export è true.

Altri modelli: Da video a video

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/luma/agent/ray/v3.2/video-to-video.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt