Přejít na obsah

Luma Ray 3.2 Video to Video

Integrace

ID modelu 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"

Tento požadavek: 0,72 $ 720 kreditů API · ≈ 77,27 ₽ Spustit na této stránce

Získat API klíč
Luma AI Video na video Synchronizace rtů5–10 saž 1080p #stylized#transform#lipsync

Úprava videa Ray 3.2, která mění styl zdrojového videa pomocí předvoleb, ovládacích prvků a klíčových snímků

Luma AI · Video

Zde se zobrazí váš první výsledek

Níže sestavte požadavek a spusťte ho pomocí svého API klíče. Výstupy se kopírují do našeho úložiště a uchovávají se navždy nebo 7 dne zdarma.

Sestavit požadavek

Ovládací prvky se generují ze schématu modelu. Kód a cena se aktualizují podle provedených změn.

•povinné 88 / 6000

Textové instrukce pro úpravu zdrojového videa.

•povinné video_url
Přetáhněte soubor nebo

URL videa, které se má upravit.

duration 5 s

Délka videa po úpravě.

resolution výchozí 540p

Výstupní rozlišení po úpravě.

Pokročilé image · user · edit_strength · auto_controls · enable_safety_checker · keyframes · controls · keyframe_indexes
start_image_url
Přetáhněte soubor nebo

Přepsání prvního snímku upraveného videa zadané jako volitelná URL obrázku; při vynechání model odvodí snímek ze zdrojového videa. Například obrázek úvodního snímku se změněným stylem může řídit vzhled úpravy.

Volitelné neprůhledné ID identifikujícího koncového uživatele, který odesílá požadavek.

Nastavení zachování zdroje při úpravách, dostupné pouze bez použití auto_controls; vynechání zvolí výchozí hodnotu modelu. Od největší odchylky po nejvěrnější zachování jsou možnosti 'reimagine_*', 'flex_*' pro vyvážený výsledek a 'adhere_*'.

Vodítka úprav s více klíčovými snímky zadaná jako URL obrázků místo start_image_url. Zadejte keyframes spolu se stejně dlouhým polem keyframe_indexes, které připne každý obrázek k pozici příslušného snímku ve zdrojovém videu; povoleno je nejvýše 64 URL.

Detailní alternativa k edit_strength, která konfiguruje podmínění samostatně pro pózu, hloubku, normály, trajektorii a obličej. Použití těchto řízení vylučuje auto_controls.

Mapování zdrojových snímků spárované jedna ku jedné s keyframes: položka [i] určuje kotevní pozici pro keyframes[i]. Obě pole musí mít stejnou délku a pozice musí být odlišné a nezáporné.

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

Spustit tento požadavek

Váš klíč zůstává v tomto prohlížeči: odesílá se pouze do Doitong API a uloží se do localStorage jen tehdy, když zaškrtnete možnost Zapamatovat. Získat klíč API

O modelu Luma Ray 3.2 Video to Video

Upravuje `video_url` podle `prompt`, volitelně s `start_image_url` pro řízení prvního snímku. `edit_strength` nabízí úrovně adhere, flex a reimagine 1 až 3, zatímco `auto_controls` nebo objekt `controls` poskytují alternativní podmiňování. Až 64 `keyframes` lze ukotvit pomocí `keyframe_indexes`. Výstup má 540p až 1080p, 5s nebo 10s, s volitelnými `hdr` a `exr_export`.

Parametry

Odešlete buď kanonický název, nebo nativní název, ne oba. Kanonické názvy

NázevTyp VýchozíPovolené Popis
promptpovinné
Typstring
≤ 6 000 znaků
Textové instrukce pro úpravu zdrojového videa.
video_urlpovinné video
Typurl · video
URL videa, které se má upravit.
uservolitelné
Typstring | null
Volitelné neprůhledné ID identifikujícího koncového uživatele, který odesílá požadavek.
start_image_urlvolitelné image
Typurl · image
Přepsání prvního snímku upraveného videa zadané jako volitelná URL obrázku; při vynechání model odvodí snímek ze zdrojového videa. Například obrázek úvodního snímku se změněným stylem může řídit vzhled úpravy.
resolutionvolitelné
Typenum
Výchozí540p
540p720p1080p
Výstupní rozlišení po úpravě.
durationvolitelné
Typenum
Výchozí5s
5s10s
Délka videa po úpravě.
edit_strengthvolitelné
Typenum
adhere_1adhere_2adhere_3flex_1flex_2flex_3reimagine_1reimagine_2reimagine_3
Nastavení zachování zdroje při úpravách, dostupné pouze bez použití auto_controls; vynechání zvolí výchozí hodnotu modelu. Od největší odchylky po nejvěrnější zachování jsou možnosti 'reimagine_*', 'flex_*' pro vyvážený výsledek a 'adhere_*'.
auto_controlsvolitelné
Typboolean
Výchozífalse
Automatické podmínění úprav: model používá zdrojové video k určení plánu místo přijetí edit_strength spolu s touto volbou.
hdrvolitelné
Typboolean
Výchozífalse
Kódování HDR pro výstup MP4 v 720p nebo 1080p, dostupné pouze účtům s přístupem k HDR.
exr_exportvolitelné
Typboolean
Výchozífalse
Další export EXR doprovázející MP4, dostupný pouze s přístupem k HDR a nastavením hdr=true.
controlsvolitelné
Typobject
Detailní alternativa k edit_strength, která konfiguruje podmínění samostatně pro pózu, hloubku, normály, trajektorii a obličej. Použití těchto řízení vylučuje auto_controls.
controls.posevolitelné
Typobject
Podmínění založené na póze nebo kostře.
controls.pose.enabledvolitelné
Typboolean
Výchozítrue
Přepínač podmínění pózou nebo kostrou při úpravách.
controls.pose.strengthvolitelné
Typenum
precisecoarse
Volba přesnosti podmínění pózou: vynecháním zachováte výchozí hodnotu, 'coarse' poskytne větší volnost a 'precise' bude zdrojovou pózu přesně sledovat.
controls.depthvolitelné
Typobject
Podmínění založené na hloubce nebo geometrii scény.
controls.depth.enabledvolitelné
Typboolean
Výchozítrue
Přepínač podmínění hloubkou nebo geometrií scény při úpravách.
controls.depth.blurvolitelné
Typnumber | null
0 – 1
Nastavení rozostření hloubky, jehož vynechání zachová výchozí hodnotu; zvýšení poskytne geometrii větší volnost.
controls.normalsvolitelné
Typobject
Podmínění založené na normálách povrchu.
controls.normals.enabledvolitelné
Typboolean
Výchozítrue
Přepínač podmínění normálami povrchu při úpravách.
controls.normals.augmentationvolitelné
Typnumber | null
0 – 1
Nastavení augmentace normál povrchu; vynecháním zachováte výchozí hodnotu, zvýšením povolíte výraznější reinterpretaci geometrie povrchu.
controls.trajectoryvolitelné
Typobject
Podmínění založené na trajektoriích pohybu.
controls.trajectory.enabledvolitelné
Typboolean
Výchozítrue
Přepínač podmínění trajektorií pohybu při úpravách.
controls.trajectory.sparsityvolitelné
Typnumber | null
0 – 1
Nastavení řídkosti trajektorie pohybu; vynecháním zachováte výchozí hodnotu, zvýšením snížíte počet použitých pohybových kotev.
controls.facevolitelné
Typobject
Podmínění založené na identitě obličeje.
controls.face.enabledvolitelné
Typboolean
Výchozítrue
Přepínač podmínění identity obličeje při úpravách.
keyframesvolitelné
Typstring[]
≤ 64 položek
Vodítka úprav s více klíčovými snímky zadaná jako URL obrázků místo start_image_url. Zadejte keyframes spolu se stejně dlouhým polem keyframe_indexes, které připne každý obrázek k pozici příslušného snímku ve zdrojovém videu; povoleno je nejvýše 64 URL.
keyframe_indexesvolitelné
Typinteger[]
≤ 64 položek
Mapování zdrojových snímků spárované jedna ku jedné s keyframes: položka [i] určuje kotevní pozici pro keyframes[i]. Obě pole musí mít stejnou délku a pozice musí být odlišné a nezáporné.
enable_safety_checkervolitelné
Typboolean
Výchozítrue
Kontrolu lze uvolnit nastavením na false, pokud je volající autorizován.
povinné Kanonický název, také podporován

Parametry souborů přijímají veřejnou adresu https:// URL, data: URI do 10 MB nebo file_url nahraného souboru. Soubory

Výstup

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"
  }
}
Vaše soubory, vaše volbaKaždý outputs[].url je kopie v našem úložišti: uchovávaná navždy (zpoplatněná za GB-měsíc) nebo 7 dne zdarma podle nastavení účtu nebo ?storage=.
Stejná struktura u každého modelutype, url, content_type, width, height a duration pro obrázky, video i zvuk. output je vlastní objekt výsledku modelu.
Pole výstupu
video
object {url, content_type, file_name, file_size}Video vytvořené modelem.
exr_file
object {url, content_type, file_name, file_size} | nullDoprovodný soubor EXR ve formě exportů Luma: buď jeden soubor EXR, nebo archiv ZIP. Vygeneruje se, když je exr_export true.

Další modely: Video na video

Pro AI agenty: tato stránka je ve formátu Markdown na adrese https://doitong.com/cs/developers/models/luma/agent/ray/v3.2/video-to-video.md. Všechny modely a návody: https://doitong.com/developers/llms.txt