Siirry sisältöön

Luma Ray 3.2 Video to Video

Integroi

Mallin tunniste 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"

Tämä pyyntö: 0,72 $ 720 API-krediittiä · ≈ 77,27 ₽ Suorita tällä sivulla

Hanki API-avain
Luma AI Videosta videoksi Huulisynkronointi5–10 senintään 1080p #stylized#transform#lipsync

Ray 3.2 -videomuokkaus, joka muuttaa lähdevideon tyyliä muokkausvoimakkuuden esiasetuksilla, ohjaimilla ja avainkuvilla

Luma AI · Video

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

•pakollinen 88 / 6000

Lähdevideon muokkaamisen tekstiohjeet.

•pakollinen video_url
Pudota tiedosto tai

Muokattavan videon URL.

duration 5 s

Videon pituus muokkauksen jälkeen.

resolution oletus 540p

Tulosteen resoluutio muokkauksen jälkeen.

Lisäasetukset image · user · edit_strength · auto_controls · enable_safety_checker · keyframes · controls · keyframe_indexes
start_image_url
Pudota tiedosto tai

Muokatun videon ensimmäisen ruudun ohitus valinnaisena kuvan URL-osoitteena; jos se jätetään pois, malli johtaa ruudun lähdevideosta. Esimerkiksi lähteestä tyylitellyn aloituskuvan toimittaminen voi ohjata muokkauksen ulkoasua.

Valinnainen läpinäkymätön tunnus, joka yksilöi pyynnön lähettävän loppukäyttäjän.

Muokkauksen lähteen säilytysasetus, joka on käytettävissä vain, kun auto_controls ei ole käytössä; pois jättäminen valitsee mallin oletuksen. Suurimmasta poikkeamasta lähimpään vastaavuuteen vaihtoehdot ovat 'reimagine_*', tasapainoiseen tulokseen 'flex_*' ja 'adhere_*'.

Monen avainruudun muokkausohjaimet toimitetaan kuvan URL-osoitteina start_image_url-arvon sijaan. Toimita keyframes yhdessä yhtä pitkän keyframe_indexes-taulukon kanssa kiinnittääksesi kunkin kuvan lähdevideon ruutusijaintiin; sallittu enintään 64 URL-osoitetta.

Edit_strength-parametrin hienojakoinen vaihtoehto, joka määrittää ehdollistamisen erikseen asennolle, syvyydelle, normaaleille, liikeradalle ja kasvoille. Näiden ohjainten käyttö sulkee auto_controls-parametrin pois.

Keyframes-parametriin yksi yhteen yhdistetty lähderuutujen määritys: alkio [i] määrittää keyframes[i]-arvon ankkurisijainnin. Taulukoiden pituuksien on oltava samat, ja sijaintien on oltava erillisiä ja ei-negatiivisia.

POST /run/luma/agent/ray/v3.2/video-to-video?wait=20 hinta → 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"

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: Luma Ray 3.2 Video to Video

Muokkaa `video_url`-videota `prompt`-kehotteen perusteella, valinnaisella `start_image_url`-kuvalla ensimmäisen kuvan ohjaamiseen. `edit_strength` tarjoaa adhere-, flex- ja reimagine-tasot 1–3, kun taas `auto_controls` tai `controls`-objekti tarjoavat vaihtoehtoisen ehdollistamisen. Enintään 64 `keyframes`-kuvaa voidaan ankkuroida `keyframe_indexes`-arvoilla. Tulostarkkuus on 540p–1080p, kesto 5s tai 10s, ja `hdr` sekä `exr_export` ovat valinnaisia.

Parametrit

Lähetä joko kanoninen nimi tai natiivi nimi, älä molempia. Kanoniset nimet

NimiTyyppi OletusSallitut Kuvaus
promptpakollinen
Tyyppistring
≤ 6 000 merkkiä
Lähdevideon muokkaamisen tekstiohjeet.
video_urlpakollinen video
Tyyppiurl · video
Muokattavan videon URL.
uservalinnainen
Tyyppistring | null
Valinnainen läpinäkymätön tunnus, joka yksilöi pyynnön lähettävän loppukäyttäjän.
start_image_urlvalinnainen image
Tyyppiurl · image
Muokatun videon ensimmäisen ruudun ohitus valinnaisena kuvan URL-osoitteena; jos se jätetään pois, malli johtaa ruudun lähdevideosta. Esimerkiksi lähteestä tyylitellyn aloituskuvan toimittaminen voi ohjata muokkauksen ulkoasua.
resolutionvalinnainen
Tyyppienum
Oletus540p
540p720p1080p
Tulosteen resoluutio muokkauksen jälkeen.
durationvalinnainen
Tyyppienum
Oletus5s
5s10s
Videon pituus muokkauksen jälkeen.
edit_strengthvalinnainen
Tyyppienum
adhere_1adhere_2adhere_3flex_1flex_2flex_3reimagine_1reimagine_2reimagine_3
Muokkauksen lähteen säilytysasetus, joka on käytettävissä vain, kun auto_controls ei ole käytössä; pois jättäminen valitsee mallin oletuksen. Suurimmasta poikkeamasta lähimpään vastaavuuteen vaihtoehdot ovat 'reimagine_*', tasapainoiseen tulokseen 'flex_*' ja 'adhere_*'.
auto_controlsvalinnainen
Tyyppiboolean
Oletusfalse
Automaattinen muokkauksen ehdollistaminen: malli käyttää lähdevideota aikataulun määrittämiseen sen sijaan, että hyväksyisi edit_strength-arvon tämän vaihtoehdon rinnalla.
hdrvalinnainen
Tyyppiboolean
Oletusfalse
HDR-koodaus MP4-tulosteelle tarkkuudella 720p tai 1080p, saatavilla vain tileille, joilla on HDR-käyttöoikeus.
exr_exportvalinnainen
Tyyppiboolean
Oletusfalse
MP4-tiedoston mukana toimitettava EXR-vienti, joka on saatavilla vain, kun sekä HDR-käyttöoikeus että hdr=true ovat käytössä.
controlsvalinnainen
Tyyppiobject
Edit_strength-parametrin hienojakoinen vaihtoehto, joka määrittää ehdollistamisen erikseen asennolle, syvyydelle, normaaleille, liikeradalle ja kasvoille. Näiden ohjainten käyttö sulkee auto_controls-parametrin pois.
controls.posevalinnainen
Tyyppiobject
Asentoon tai luurankoon perustuva ehdollistaminen.
controls.pose.enabledvalinnainen
Tyyppiboolean
Oletustrue
Asennon tai luurangon ehdollistamisen vaihtokytkin muokkauksen aikana.
controls.pose.strengthvalinnainen
Tyyppienum
precisecoarse
Asentoehdollistamisen tarkkuuden valinta: säilytä oletus jättämällä arvo pois, valitse 'coarse' suurempaa vapautta varten tai käytä 'precise' seurataksesi lähteen asentoa tarkasti.
controls.depthvalinnainen
Tyyppiobject
Syvyyteen tai kohtauksen geometriaan perustuva ehdollistaminen.
controls.depth.enabledvalinnainen
Tyyppiboolean
Oletustrue
Syvyyden tai kohtausgeometrian ehdollistamisen vaihtokytkin muokkauksen aikana.
controls.depth.blurvalinnainen
Tyyppinumber | null
0 – 1
Syvyyden sumennusasetus, joka jätetään määrittämättä oletuksen säilyttämiseksi tai jota suurennetaan geometrian vapauden lisäämiseksi.
controls.normalsvalinnainen
Tyyppiobject
Pintanormaaleihin perustuva ehdollistaminen.
controls.normals.enabledvalinnainen
Tyyppiboolean
Oletustrue
Pintanormaaleihin perustuvan ehdollistamisen vaihtokytkin muokkauksen aikana.
controls.normals.augmentationvalinnainen
Tyyppinumber | null
0 – 1
Pintanormaalien augmentointiasetus; säilytä oletus jättämällä arvo pois tai suurenna sitä salliaksesi pinnan geometrian laajemman uudelleentulkinnan.
controls.trajectoryvalinnainen
Tyyppiobject
Liikeratoihin perustuva ehdollistaminen.
controls.trajectory.enabledvalinnainen
Tyyppiboolean
Oletustrue
Liikerataehdollistamisen vaihtokytkin muokkauksen aikana.
controls.trajectory.sparsityvalinnainen
Tyyppinumber | null
0 – 1
Liikerataehdollistamisen harvuusasetus; jätä se pois säilyttääksesi oletuksen tai suurenna sitä vähentääksesi käytettyjen liikeankkurien määrää.
controls.facevalinnainen
Tyyppiobject
Kasvojen identiteettiin perustuva ehdollistaminen.
controls.face.enabledvalinnainen
Tyyppiboolean
Oletustrue
Kasvoidentiteetin ehdollistamisen vaihtokytkin muokkauksen aikana.
keyframesvalinnainen
Tyyppistring[]
≤ 64 kohdetta
Monen avainruudun muokkausohjaimet toimitetaan kuvan URL-osoitteina start_image_url-arvon sijaan. Toimita keyframes yhdessä yhtä pitkän keyframe_indexes-taulukon kanssa kiinnittääksesi kunkin kuvan lähdevideon ruutusijaintiin; sallittu enintään 64 URL-osoitetta.
keyframe_indexesvalinnainen
Tyyppiinteger[]
≤ 64 kohdetta
Keyframes-parametriin yksi yhteen yhdistetty lähderuutujen määritys: alkio [i] määrittää keyframes[i]-arvon ankkurisijainnin. Taulukoiden pituuksien on oltava samat, ja sijaintien on oltava erillisiä ja ei-negatiivisia.
enable_safety_checkervalinnainen
Tyyppiboolean
Oletustrue
Suodatusta voi höllentää asettamalla arvoksi false, jos kutsujalla on siihen valtuutus.
pakollinen Kanoninen nimi, myös hyväksytty

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

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"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
video
object {url, content_type, file_name, file_size}Mallin tuottama video.
exr_file
object {url, content_type, file_name, file_size} | nullEXR-oheistiedosto Luma-viennin muodossa: joko yksi EXR-tiedosto tai ZIP-arkisto. Se generoidaan, kun exr_export on true.

Lisää malleja: Videosta videoksi

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/luma/agent/ray/v3.2/video-to-video.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt