Sleppa yfir í efni

Luma Ray 3.2 Video to Video

Tengja

Auðkenni líkans 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"

Þessi beiðni: 0,72 $ 720 API-inneignir · ≈ 77,27 ₽ Keyra á þessari síðu

Fá API-lykil
Luma AI Myndband í myndband Varasamstilling5–10 sallt að 1080p #stylized#transform#lipsync

Ray 3.2-myndskeiðsvinnsla sem endurstílar upprunamyndskeið með forstillingum fyrir vinnslustyrk, stýringum og lykilrömmum

Luma AI · Myndband

Fyrsta niðurstaðan þín birtist hér

Búðu til beiðni hér að neðan og keyrðu hana með API-lyklinum þínum. Úttök eru afrituð í geymsluna okkar og geymd að eilífu eða 7 dagar án kostnaðar.

Búa til beiðni

Stýringar eru búnar til út frá líkanaskemanu. Kóðinn og verðið uppfærast þegar þú breytir þeim.

•áskilið 88 / 6000

Textaleiðbeiningar fyrir breytingu á upprunamyndbandinu.

•áskilið video_url
Slepptu skrá eða

URL myndbandsins sem á að breyta.

duration 5 s

Lengd myndbandsins eftir breytingu.

resolution sjálfgefið 540p

Úttaksupplausn eftir breytingu.

Ítarlegt image · user · edit_strength · auto_controls · enable_safety_checker · keyframes · controls · keyframe_indexes
start_image_url
Slepptu skrá eða

Yfirskrift fyrsta ramma fyrir breytta myndbandið, gefin sem valfrjálst URL myndar; ef því er sleppt dregur líkanið þann ramma úr upprunamyndbandinu. Til dæmis getur upphafsmynd með breyttum stíl úr upprunanum stýrt útliti breytingarinnar.

Valfrjálst ógegnsætt auðkenni sem auðkennir lokanotandann sem sendir beiðnina.

Stilling fyrir varðveislu uppruna við breytingar, aðeins tiltæk þegar auto_controls er ekki notað; ef henni er sleppt er sjálfgefið gildi líkansins valið. Frá mestu fráviki til nánustu eftirfylgni eru valkostirnir 'reimagine_*', 'flex_*' fyrir jafnvægisniðurstöðu og 'adhere_*'.

Leiðbeiningar fyrir breytingu með mörgum lykilrömmum, gefnar sem URL mynda í stað start_image_url. Gefðu upp keyframes ásamt jafnlangri keyframe_indexes-fylkisröð til að festa hverja mynd við rammastaðsetningu hennar í upprunamyndbandinu; að hámarki 64 URL eru leyfð.

Nákvæmari valkostur en edit_strength sem stillir skilyrðingu sérstaklega fyrir stellingu, dýpt, normalen, feril og andlit. Notkun þessara stýringa útilokar auto_controls.

Kortlagning upprunaramma pöruð einn við einn við lykilramma: færsla [i] tilgreinir festingarstaðsetningu keyframes[i]. Fylkin tvö verða að vera jafn löng og staðsetningar verða að vera ólíkar og óneikvæðar.

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

Keyra þessa beiðni

Lykillinn þinn er áfram í þessum vafra: hann er aðeins sendur til Doitong API og vistaður í localStorage aðeins ef þú hakar við Muna. Fá API-lykil

Um Luma Ray 3.2 Video to Video

Vinnur úr `video_url` samkvæmt `prompt`, með valfrjálsu `start_image_url` til að stýra fyrsta rammanum. `edit_strength` býður upp á adhere-, flex- og reimagine-stig 1 til 3, en `auto_controls` eða `controls`-hlutur gefur aðra skilyrðingu. Hægt er að festa allt að 64 `keyframes` með `keyframe_indexes`. Úttak er 540p til 1080p, 5s eða 10s, með valfrjálsu `hdr` og `exr_export`.

Færibreytur

Sendu annaðhvort samræmda heitið eða upprunalega heitið, ekki bæði. Samræmd heiti

HeitiGerð SjálfgefiðLeyfilegt Lýsing
promptáskilið
Gerðstring
≤ 6.000 stafir
Textaleiðbeiningar fyrir breytingu á upprunamyndbandinu.
video_urláskilið video
Gerðurl · video
URL myndbandsins sem á að breyta.
uservalfrjálst
Gerðstring | null
Valfrjálst ógegnsætt auðkenni sem auðkennir lokanotandann sem sendir beiðnina.
start_image_urlvalfrjálst image
Gerðurl · image
Yfirskrift fyrsta ramma fyrir breytta myndbandið, gefin sem valfrjálst URL myndar; ef því er sleppt dregur líkanið þann ramma úr upprunamyndbandinu. Til dæmis getur upphafsmynd með breyttum stíl úr upprunanum stýrt útliti breytingarinnar.
resolutionvalfrjálst
Gerðenum
Sjálfgefið540p
540p720p1080p
Úttaksupplausn eftir breytingu.
durationvalfrjálst
Gerðenum
Sjálfgefið5s
5s10s
Lengd myndbandsins eftir breytingu.
edit_strengthvalfrjálst
Gerðenum
adhere_1adhere_2adhere_3flex_1flex_2flex_3reimagine_1reimagine_2reimagine_3
Stilling fyrir varðveislu uppruna við breytingar, aðeins tiltæk þegar auto_controls er ekki notað; ef henni er sleppt er sjálfgefið gildi líkansins valið. Frá mestu fráviki til nánustu eftirfylgni eru valkostirnir 'reimagine_*', 'flex_*' fyrir jafnvægisniðurstöðu og 'adhere_*'.
auto_controlsvalfrjálst
Gerðboolean
Sjálfgefiðfalse
Sjálfvirk skilyrðing breytingar: líkanið notar upprunamyndbandið til að ákvarða áætlunina í stað þess að taka við edit_strength samhliða þessum valkosti.
hdrvalfrjálst
Gerðboolean
Sjálfgefiðfalse
HDR-kóðun fyrir MP4-úttak í annaðhvort 720p eða 1080p, aðeins tiltæk fyrir reikninga með HDR-aðgang.
exr_exportvalfrjálst
Gerðboolean
Sjálfgefiðfalse
Viðbótar EXR-útflutningur ásamt MP4, aðeins tiltækur með bæði HDR-aðgangi og hdr=true.
controlsvalfrjálst
Gerðobject
Nákvæmari valkostur en edit_strength sem stillir skilyrðingu sérstaklega fyrir stellingu, dýpt, normalen, feril og andlit. Notkun þessara stýringa útilokar auto_controls.
controls.posevalfrjálst
Gerðobject
Skilyrðing byggð á stellingu eða beinagrind.
controls.pose.enabledvalfrjálst
Gerðboolean
Sjálfgefiðtrue
Rofi fyrir skilyrðingu stellingar eða beinagrindar við breytingu.
controls.pose.strengthvalfrjálst
Gerðenum
precisecoarse
Val á nákvæmni stellingarskilyrðingar: slepptu færibreytunni til að halda sjálfgefnu gildi, veldu 'coarse' fyrir meira frelsi eða notaðu 'precise' til að fylgja stellingu upprunans náið.
controls.depthvalfrjálst
Gerðobject
Skilyrðing byggð á dýpt eða rúmfræði senu.
controls.depth.enabledvalfrjálst
Gerðboolean
Sjálfgefiðtrue
Rofi fyrir skilyrðingu dýptar eða rúmfræði senu við breytingu.
controls.depth.blurvalfrjálst
Gerðnumber | null
0 – 1
Dýptaróskýringu er sleppt til að halda sjálfgefnu gildi eða hún aukin til að gefa rúmfræðinni meira frelsi.
controls.normalsvalfrjálst
Gerðobject
Skilyrðing byggð á yfirborðsnormalum.
controls.normals.enabledvalfrjálst
Gerðboolean
Sjálfgefiðtrue
Rofi fyrir skilyrðingu yfirborðsnormal­a við breytingu.
controls.normals.augmentationvalfrjálst
Gerðnumber | null
0 – 1
Stilling fyrir aukningu yfirborðsnormal­a; slepptu henni til að halda sjálfgefnu gildi eða hækkaðu hana til að leyfa meiri endurtúlkun yfirborðsgeómetríu.
controls.trajectoryvalfrjálst
Gerðobject
Skilyrðing byggð á hreyfiferlum.
controls.trajectory.enabledvalfrjálst
Gerðboolean
Sjálfgefiðtrue
Rofi fyrir skilyrðingu hreyfiferils við breytingu.
controls.trajectory.sparsityvalfrjálst
Gerðnumber | null
0 – 1
Stilling fyrir dreifingu hreyfiferils; slepptu henni til að halda sjálfgefnu gildi eða hækkaðu hana til að fækka notuðum hreyfifestum.
controls.facevalfrjálst
Gerðobject
Skilyrðing byggð á andlitsauðkenni.
controls.face.enabledvalfrjálst
Gerðboolean
Sjálfgefiðtrue
Rofi fyrir skilyrðingu andlitsauðkennis við breytingu.
keyframesvalfrjálst
Gerðstring[]
≤ 64 atriði
Leiðbeiningar fyrir breytingu með mörgum lykilrömmum, gefnar sem URL mynda í stað start_image_url. Gefðu upp keyframes ásamt jafnlangri keyframe_indexes-fylkisröð til að festa hverja mynd við rammastaðsetningu hennar í upprunamyndbandinu; að hámarki 64 URL eru leyfð.
keyframe_indexesvalfrjálst
Gerðinteger[]
≤ 64 atriði
Kortlagning upprunaramma pöruð einn við einn við lykilramma: færsla [i] tilgreinir festingarstaðsetningu keyframes[i]. Fylkin tvö verða að vera jafn löng og staðsetningar verða að vera ólíkar og óneikvæðar.
enable_safety_checkervalfrjálst
Gerðboolean
Sjálfgefiðtrue
Hægt er að slaka á skimun með því að stilla false, ef beiðandi hefur heimild.
áskilið Samræmt heiti, einnig samþykkt

Skrárfæribreytur taka við opinberri https://-vefslóð, data:-URI allt að 10 MB eða file_url fyrir upphleðslu. Skrár

Úttak

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"
  }
}
Skrárnar þínar, þitt valHvert outputs[].url er afrit í geymslunni okkar: geymt að eilífu (greitt fyrir hvert GB-mánuðargildi) eða 7 dagar án kostnaðar, eftir stillingu aðgangsins þíns eða ?storage=.
Sama lögun í öllum líkönumtype, url, content_type, width, height og duration, jafnt fyrir myndir, myndbönd og hljóð. output er eigið niðurstöðuhlutur líkansins.
Reitir úttaks
video
object {url, content_type, file_name, file_size}Myndband sem líkanið býr til.
exr_file
object {url, content_type, file_name, file_size} | nullEXR-hliðarskrá á því formi sem Luma flytur út: annaðhvort ein EXR-skrá eða ZIP-skjalasafn. Hún er búin til þegar exr_export er true.

Fleiri líkön: Myndband í myndband

Fyrir gervigreindarþjóna: þessi síða á Markdown-sniði er á https://doitong.com/is/developers/models/luma/agent/ray/v3.2/video-to-video.md. Öll líkön og leiðbeiningar: https://doitong.com/developers/llms.txt