Léim chuig an ábhar

Luma Ray 3.2 Video to Video

Comhtháthú

Aitheantas na samhla 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"

An t-iarratas seo: $0.72 720 gcreidmheas API · ≈ ₽77.27 Rith ar an leathanach seo

Faigh eochair API
Luma AI Físeán go Físeán Sioncronú liopaí5–10 ssuas le 1080p #stylized#transform#lipsync

Eagarthóireacht físeáin Ray 3.2 a athstílíonn físeán foinse le réamhshocruithe neart eagarthóireachta, rialuithe agus príomhfhrámaí

Luma AI · Físeán

Beidh do chéad toradh anseo

Tóg iarratas thíos agus rith é le d’eochair API. Cóipeáiltear na haschuir chuig ár stóráil, coinnithe go deo nó ar feadh 7 lá saor in aisce.

Tóg iarratas

Gintear na rialtáin ó scéim na samhla. Nuashonraítear an cód agus an praghas de réir mar a athraíonn tú iad.

•riachtanach 88 / 6000

Treoracha téacs chun an físeán foinse a chur in eagar.

•riachtanach video_url
Scaoil comhad, nó

URL don fhíseán atá á chur in eagar.

duration 5 s

Fad an fhíseáin tar éis eagarthóireachta.

resolution réamhshocrú 540p

Taifeach aschuir tar éis eagarthóireachta.

Ardleibhéal image · user · edit_strength · auto_controls · enable_safety_checker · keyframes · controls · keyframe_indexes
start_image_url
Scaoil comhad, nó

Sárú ar chéad fhráma an fhíseáin eagarthaithe, soláthraithe mar URL íomhá roghnach; nuair a fhágtar ar lár é, díorthaíonn an tsamhail an fráma sin ón bhfíseán foinse. Mar shampla, is féidir le híomhá oscailte athstílithe ón bhfoinse cuma na heagarthóireachta a threorú.

Aitheantóir teimhneach roghnach a shainaithníonn an t-úsáideoir deiridh a sheolann an t-iarratas.

Socrú caomhnaithe na foinse le haghaidh eagarthóireachta, ar fáil ach amháin nuair nach n-úsáidtear auto_controls; roghnaíonn fágáil ar lár réamhshocrú na samhla. Ón imeacht is mó go dtí an cloí is gaire, is iad na roghanna 'reimagine_*', 'flex_*' le haghaidh toradh cothrom, agus 'adhere_*'.

Treoraithe eagarthóireachta il-eochairfhráma soláthraithe mar URLanna íomhánna in ionad start_image_url. Soláthair keyframes in éineacht le heagar keyframe_indexes den fhad céanna chun gach íomhá a cheangal le suíomh a fráma san fhíseán foinse; ceadaítear 64 URL ar a mhéad.

Rogha mhalartach mhionchruinn ar edit_strength a chumraíonn coinníollú ar leithligh do staidiúir, doimhneacht, gnáthveicteoirí, conair agus aghaidh. Cuireann úsáid na rialuithe seo cosc ar auto_controls.

Mapáil frámaí foinse péireáilte duine le duine le keyframes: sonraíonn iontráil [i] suíomh ancaire keyframes[i]. Caithfidh an dá eagar a bheith ar comhfhad, agus caithfidh suíomhanna a bheith éagsúil agus neamhdiúltach.

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

Rith an t-iarratas seo

Fanann d'eochair sa bhrabhsálaí seo: seoltar chuig Doitong API amháin í agus sábháiltear (localStorage) í ach amháin má chuireann tú tic le Meabhraigh. Faigh eochair API

Maidir le Luma Ray 3.2 Video to Video

Eagraíonn sé `video_url` de réir `prompt`, le `start_image_url` roghnach chun an chéad fhráma a stiúradh. Cuireann `edit_strength` leibhéil adhere, flex agus reimagine 1 go 3 ar fáil, agus soláthraíonn `auto_controls` nó réad `controls` riochtú malartach. Is féidir suas le 64 `keyframes` a ancaire le `keyframe_indexes`. Is é 540p go 1080p an t-aschur, 5s nó 10s, le `hdr` agus `exr_export` roghnach.

Paraiméadair

Seol an t-ainm canónach nó an t-ainm dúchasach, ní an dá cheann. Ainmneacha canónacha

AinmCineál RéamhshocrúCeadaithe Cur síos
promptriachtanach
Cineálstring
≤ 6,000 gcarachtar
Treoracha téacs chun an físeán foinse a chur in eagar.
video_urlriachtanach video
Cineálurl · video
URL don fhíseán atá á chur in eagar.
userroghnach
Cineálstring | null
Aitheantóir teimhneach roghnach a shainaithníonn an t-úsáideoir deiridh a sheolann an t-iarratas.
start_image_urlroghnach image
Cineálurl · image
Sárú ar chéad fhráma an fhíseáin eagarthaithe, soláthraithe mar URL íomhá roghnach; nuair a fhágtar ar lár é, díorthaíonn an tsamhail an fráma sin ón bhfíseán foinse. Mar shampla, is féidir le híomhá oscailte athstílithe ón bhfoinse cuma na heagarthóireachta a threorú.
resolutionroghnach
Cineálenum
Réamhshocrú540p
540p720p1080p
Taifeach aschuir tar éis eagarthóireachta.
durationroghnach
Cineálenum
Réamhshocrú5s
5s10s
Fad an fhíseáin tar éis eagarthóireachta.
edit_strengthroghnach
Cineálenum
adhere_1adhere_2adhere_3flex_1flex_2flex_3reimagine_1reimagine_2reimagine_3
Socrú caomhnaithe na foinse le haghaidh eagarthóireachta, ar fáil ach amháin nuair nach n-úsáidtear auto_controls; roghnaíonn fágáil ar lár réamhshocrú na samhla. Ón imeacht is mó go dtí an cloí is gaire, is iad na roghanna 'reimagine_*', 'flex_*' le haghaidh toradh cothrom, agus 'adhere_*'.
auto_controlsroghnach
Cineálboolean
Réamhshocrúfalse
Coinníollú uathoibríoch eagarthóireachta: úsáideann an tsamhail an físeán foinse chun an sceideal a chinneadh seachas glacadh le edit_strength in éineacht leis an rogha seo.
hdrroghnach
Cineálboolean
Réamhshocrúfalse
Ionchódú HDR d’aschur MP4 ag 720p nó 1080p, ar fáil do chuntais a bhfuil rochtain HDR acu amháin.
exr_exportroghnach
Cineálboolean
Réamhshocrúfalse
Easpórtáil EXR bhreise in éineacht leis an MP4, ar fáil ach amháin le rochtain HDR agus hdr=true araon.
controlsroghnach
Cineálobject
Rogha mhalartach mhionchruinn ar edit_strength a chumraíonn coinníollú ar leithligh do staidiúir, doimhneacht, gnáthveicteoirí, conair agus aghaidh. Cuireann úsáid na rialuithe seo cosc ar auto_controls.
controls.poseroghnach
Cineálobject
Coinníollú bunaithe ar staidiúir nó ar chnámharlach.
controls.pose.enabledroghnach
Cineálboolean
Réamhshocrútrue
Scorán le haghaidh coinníollú staidiúir nó cnámharlaigh le linn eagarthóireachta.
controls.pose.strengthroghnach
Cineálenum
precisecoarse
Roghnú beachtais choinníollú staidiúir: coinnigh an réamhshocrú trína fhágáil ar lár, roghnaigh 'coarse' le haghaidh níos mó saoirse, nó úsáid 'precise' chun staidiúir na foinse a leanúint go docht.
controls.depthroghnach
Cineálobject
Coinníollú bunaithe ar dhoimhneacht nó ar gheoiméadracht an radhairc.
controls.depth.enabledroghnach
Cineálboolean
Réamhshocrútrue
Scorán le haghaidh coinníollú doimhneachta nó gheoiméadracht an radhairc le linn eagarthóireachta.
controls.depth.blurroghnach
Cineálnumber | null
0 – 1
Socrú doiléire doimhneachta, fágtha gan sonrú chun an réamhshocrú a choinneáil nó méadaithe chun níos mó saoirse a thabhairt don gheoiméadracht.
controls.normalsroghnach
Cineálobject
Coinníollú bunaithe ar ghnáthveicteoirí dromchla.
controls.normals.enabledroghnach
Cineálboolean
Réamhshocrútrue
Scorán le haghaidh coinníollú gnáthveicteoirí dromchla le linn eagarthóireachta.
controls.normals.augmentationroghnach
Cineálnumber | null
0 – 1
Socrú méadaithe gnáthveicteoirí dromchla; coinnigh an réamhshocrú trína fhágáil ar lár, nó méadaigh é chun athléirmhíniú níos mó ar gheoiméadracht an dromchla a cheadú.
controls.trajectoryroghnach
Cineálobject
Coinníollú bunaithe ar chonairí gluaisne.
controls.trajectory.enabledroghnach
Cineálboolean
Réamhshocrútrue
Scorán le haghaidh coinníollú conairí gluaisne le linn eagarthóireachta.
controls.trajectory.sparsityroghnach
Cineálnumber | null
0 – 1
Socrú tearcachta conaire gluaisne; fág ar lár é chun an réamhshocrú a choinneáil, nó méadaigh é chun líon na n-ancaire gluaisne a úsáidtear a laghdú.
controls.faceroghnach
Cineálobject
Coinníollú bunaithe ar chéannacht aghaidhe.
controls.face.enabledroghnach
Cineálboolean
Réamhshocrútrue
Scorán le haghaidh coinníollú chéannacht na haghaidhe le linn eagarthóireachta.
keyframesroghnach
Cineálstring[]
≤ 64 mír
Treoraithe eagarthóireachta il-eochairfhráma soláthraithe mar URLanna íomhánna in ionad start_image_url. Soláthair keyframes in éineacht le heagar keyframe_indexes den fhad céanna chun gach íomhá a cheangal le suíomh a fráma san fhíseán foinse; ceadaítear 64 URL ar a mhéad.
keyframe_indexesroghnach
Cineálinteger[]
≤ 64 mír
Mapáil frámaí foinse péireáilte duine le duine le keyframes: sonraíonn iontráil [i] suíomh ancaire keyframes[i]. Caithfidh an dá eagar a bheith ar comhfhad, agus caithfidh suíomhanna a bheith éagsúil agus neamhdiúltach.
enable_safety_checkerroghnach
Cineálboolean
Réamhshocrútrue
Is féidir an scagadh a mhaolú trí false a shocrú, ar choinníoll go bhfuil údarú ag an nglaoiteoir.
riachtanach Ainm canónach, glactar leis freisin

Glacann paraiméadair chomhaid le URL poiblí https://, URI data: suas le 10 MB, nó file_url uaslódála. Comhaid

Aschur

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"
  }
}
Do chuid comhad, do roghaIs cóip ar ár stóráil é gach outputs[].url: coinnithe go deo (íoctha in aghaidh GB-mhí) nó ar feadh 7 lá saor in aisce, de réir shocrú do chuntais nó ?storage=.
An cruth céanna ar gach samhailtype, url, content_type, width, height agus duration, d'íomhánna, d'fhíseáin agus d'fhuaim araon. Is é output réad toraidh na samhla féin.
Réimsí aschuir
video
object {url, content_type, file_name, file_size}An físeán a tháirg an tsamhail.
exr_file
object {url, content_type, file_name, file_size} | nullComhad taobh EXR i bhfoirm easpórtálacha Luma: comhad EXR amháin nó cartlann ZIP. Gintear é nuair atá exr_export true.

Tuilleadh samhlacha: Físeán go Físeán

Do ghníomhairí AI: tá an leathanach seo mar Markdown ag https://doitong.com/ga/developers/models/luma/agent/ray/v3.2/video-to-video.md. Gach samhail agus treoir: https://doitong.com/developers/llms.txt