שפּרינגען צו אינהאַלט

Luma Ray 3.2 Video to Video

אינטעגרירן

מאָדעל־id 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"

דער דאָזיקער ריקוועסט: ⁨$ 0.72⁩ 720 API־קרעדיטן · ≈ ⁨₽ 77.27⁩ לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Luma AI ווידעא צו ווידעא ליפּסינק5–10 sביז 1080p #stylized#transform#lipsync

Ray 3.2 ווידעאָ־עדיטינג וואָס ענדערט דעם סטיל פֿון אַ מקור־ווידעאָ מיט עדיט־שטאַרקייט־פּרעסעטן, קאָנטראָלן און קי־פֿריימס

Luma AI · ווידעא

דאָ קומט אײַער ערשטער רעזולטאַט

בויט אונטן אַ בקשה און לויפט זי מיט אײַער API שליסל. רעזולטאַטן ווערן קאַפּירט צו אונדזער סטאָרידזש, געהאַלטן אויף אייביק אָדער 7 טעג אומזיסט.

בויען אַ בעטן

קאָנטראָלן ווערן דזשענערירט פֿון דעם מאָדעל־סכעמע. דער קאָד און דער פּרײַז דערהײַנטיקן זיך ווען איר ענדערט זיי.

•פארלאנגט 88 / 6000

טעקסט־אנווײַזונגען פֿאַר רעדאַקטירן דעם מקור־ווידעא.

•פארלאנגט video_url
לייגט אַרײַן אַ טעקע, אָדער

URL פֿאַר דער ווידעא וואָס ווערט רעדאַקטירט.

duration 5 s

לענג פֿון דער ווידעא נאָך רעדאַקטירונג.

resolution סטאַנדאַרט 540p

רעזולטאַט־רעזאָלוציע נאָך רעדאַקטירונג.

פֿאָרגעשריטן image · user · edit_strength · auto_controls · enable_safety_checker · keyframes · controls · keyframe_indexes
start_image_url
לייגט אַרײַן אַ טעקע, אָדער

איבערדרוק פֿון ערשטן ראַם פֿאַר דער רעדאַקטירטער ווידעא, צוגעשטעלט ווי אַן אָפּציאָנעלע בילד־URL; ווען עס פֿעלט, דערלאַנגט דער מאָדעל דעם ראַם פֿון דער מקור־ווידעא. צום בײַשפּיל, אַן אַרײַנגעגעבענער רעסטיילטער עפֿענונגס־בילד פֿון דער מקור קען פירן דעם אויסזען פֿון דער רעדאַקטירונג.

אָפּציאָנעלע אָופּקע ID וואָס אידענטיפֿיצירט דעם סוף־באַניצער וואָס שיקט די בקשה.

מקור־אָפּהיטונג־באַשטעטיקונג פֿאַר רעדאַקטירונגען, בנימצא בלויז ווען auto_controls ווערט נישט געניצט; אויסלאָזן קלייבט דעם סטאַנדאַרט פֿונעם מאָדעל. פֿון גרעסטער אָפּווײַכונג ביז נאָענטסטער נאָכפֿאָלג זענען די אָפּציעס 'reimagine_*', 'flex_*' פֿאַר אַ באַלאַנסירטן רעזולטאַט, און 'adhere_*'.

מולטי־קי־פֿרעם־רעדאַקטירונג־גיידס צוגעשטעלט ווי בילד־URLs אַנשטאָט start_image_url. צושטעלן קי־פֿרעמס צוזאַמען מיט אַן גלײַכלאַנגן keyframe_indexes אַרריי צו פֿאַרבינדן יעדן בילד מיט זײַן מקור־ווידעא־ראַם־פּאָזיציע; מעגלעך מאַקסימום 64 URLs.

פֿײַן־גראַנולירטע אַלטערנאַטיוו צו edit_strength וואָס באַשטימט קאָנדיציאָנירונג באַזונדער פֿאַר פּאָזע, טיפֿקייט, נאָרמאַלן, טראַדזשעקטאָריע און פּנים. ניצן די קאָנטראָלן שליסט auto_controls אויס.

מקור־ראַם־מאַפּינג צוגעפּאַסט איינס־צו־איינס צו קי־פֿרעמס: איינטראָג [i] ספּעציפֿיצירט די אַנקער־פּאָזיציע פֿאַר keyframes[i]. ביידע אַררייס מוזן האָבן גלײַכע לענגען, און פּאָזיציעס מוזן זײַן באַזונדערע און נישט־נעגאַטיוו.

POST /run/luma/agent/ray/v3.2/video-to-video?wait=20 פּרײַז → ⁨$ 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"

לויפֿן דעם ריקוועסט

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן Luma Ray 3.2 Video to Video

עדיטירט אַ `video_url` לויט אַ `prompt`, מיט אַן אָפּציאָנאַלן `start_image_url` צו פֿירן דעם ערשטן פֿריים. `edit_strength` אָפפערט adhere, flex און reimagine לעוועלס 1 ביז 3, בשעת `auto_controls` אָדער אַ `controls` אָביעקט צושטעלן אַלטערנאַטיווע באַדינגונג. ביז 64 `keyframes` קענען ווערן אַנגקערד מיט `keyframe_indexes`. דער רעזולטאַט איז 540p ביז 1080p, 5s אָדער 10s, מיט אָפּציאָנאַלע `hdr` און `exr_export`.

פּאַראַמעטערס

שיקט אָדער דעם קאַנאָנישן נאָמען אָדער דעם נאַטיוון נאָמען, נישט ביידע. קאַנאָנישע נעמען

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
promptפארלאנגט
טיפּstring
≤ 6,000 כאַראַקטערן
טעקסט־אנווײַזונגען פֿאַר רעדאַקטירן דעם מקור־ווידעא.
video_urlפארלאנגט video
טיפּurl · video
URL פֿאַר דער ווידעא וואָס ווערט רעדאַקטירט.
userאָפּציאָנעל
טיפּstring | null
אָפּציאָנעלע אָופּקע ID וואָס אידענטיפֿיצירט דעם סוף־באַניצער וואָס שיקט די בקשה.
start_image_urlאָפּציאָנעל image
טיפּurl · image
איבערדרוק פֿון ערשטן ראַם פֿאַר דער רעדאַקטירטער ווידעא, צוגעשטעלט ווי אַן אָפּציאָנעלע בילד־URL; ווען עס פֿעלט, דערלאַנגט דער מאָדעל דעם ראַם פֿון דער מקור־ווידעא. צום בײַשפּיל, אַן אַרײַנגעגעבענער רעסטיילטער עפֿענונגס־בילד פֿון דער מקור קען פירן דעם אויסזען פֿון דער רעדאַקטירונג.
resolutionאָפּציאָנעל
טיפּenum
סטאַנדאַרט540p
540p720p1080p
רעזולטאַט־רעזאָלוציע נאָך רעדאַקטירונג.
durationאָפּציאָנעל
טיפּenum
סטאַנדאַרט5s
5s10s
לענג פֿון דער ווידעא נאָך רעדאַקטירונג.
edit_strengthאָפּציאָנעל
טיפּenum
adhere_1adhere_2adhere_3flex_1flex_2flex_3reimagine_1reimagine_2reimagine_3
מקור־אָפּהיטונג־באַשטעטיקונג פֿאַר רעדאַקטירונגען, בנימצא בלויז ווען auto_controls ווערט נישט געניצט; אויסלאָזן קלייבט דעם סטאַנדאַרט פֿונעם מאָדעל. פֿון גרעסטער אָפּווײַכונג ביז נאָענטסטער נאָכפֿאָלג זענען די אָפּציעס 'reimagine_*', 'flex_*' פֿאַר אַ באַלאַנסירטן רעזולטאַט, און 'adhere_*'.
auto_controlsאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
אָטאָמאַטישע רעדאַקטירונג־קאָנדיציאָנירונג: דער מאָדעל ניצט דעם מקור־ווידעא צו באַשטימען דעם פּלאַן, אַנשטאָט צו אָננעמען edit_strength צוזאַמען מיט דער אָפּציע.
hdrאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
HDR קאָדירונג פֿאַר MP4 רעזולטאַט בײַ 720p אָדער 1080p, בנימצא בלויז פֿאַר אַקאַונטן מיט HDR צוטריט.
exr_exportאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
צוגאָב־EXR עקספּאָרט צוזאַמען מיט MP4, בנימצא בלויז מיט סײַ HDR צוטריט סײַ hdr=true.
controlsאָפּציאָנעל
טיפּobject
פֿײַן־גראַנולירטע אַלטערנאַטיוו צו edit_strength וואָס באַשטימט קאָנדיציאָנירונג באַזונדער פֿאַר פּאָזע, טיפֿקייט, נאָרמאַלן, טראַדזשעקטאָריע און פּנים. ניצן די קאָנטראָלן שליסט auto_controls אויס.
controls.poseאָפּציאָנעל
טיפּobject
קאָנדיציאָנירונג באַזירט אויף פּאָזע אָדער סקעלעט.
controls.pose.enabledאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
קנעפּל פֿאַר פּאָזע־ אָדער סקעלעט־קאָנדיציאָנירונג בעת רעדאַקטירונג.
controls.pose.strengthאָפּציאָנעל
טיפּenum
precisecoarse
פּינקטלעכקייט־קלייב פֿאַר פּאָזע־קאָנדיציאָנירונג: לאָז אויס צו האַלטן דעם סטאַנדאַרט, קלייב 'coarse' פֿאַר מער פֿרײַהייט, אָדער ניצ 'precise' צו נאָענט נאָכפֿאָלגן די מקור־פּאָזע.
controls.depthאָפּציאָנעל
טיפּobject
קאָנדיציאָנירונג באַזירט אויף טיפֿקייט אָדער סצענע־געאָמעטריע.
controls.depth.enabledאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
קנעפּל פֿאַר טיפֿקייט־ אָדער סצענע־געאָמעטריע־קאָנדיציאָנירונג בעת רעדאַקטירונג.
controls.depth.blurאָפּציאָנעל
טיפּnumber | null
0 – 1
טיפֿקייט־בלער־באַשטעטיקונג, לאָז אויס צו האַלטן דעם סטאַנדאַרט אָדער פֿאַרגרעסער צו געבן דער געאָמעטריע מער פֿרײַהייט.
controls.normalsאָפּציאָנעל
טיפּobject
קאָנדיציאָנירונג באַזירט אויף ייבערפֿלאַך־נאָרמאַלן.
controls.normals.enabledאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
קנעפּל פֿאַר ייבערפֿלאַך־נאָרמאַל־קאָנדיציאָנירונג בעת רעדאַקטירונג.
controls.normals.augmentationאָפּציאָנעל
טיפּnumber | null
0 – 1
ייבערפֿלאַך־נאָרמאַל־פֿאַרגרעסערונג־באַשטעטיקונג; לאָז אויס צו האַלטן דעם סטאַנדאַרט אָדער פֿאַרגרעסער צו דערלויבן גרעסערע ווידער־אויסטײַטשונג פֿון ייבערפֿלאַך־געאָמעטריע.
controls.trajectoryאָפּציאָנעל
טיפּobject
קאָנדיציאָנירונג באַזירט אויף באַוועגונג־טראַדזשעקטאָריעס.
controls.trajectory.enabledאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
קנעפּל פֿאַר באַוועגונג־טראַדזשעקטאָריע־קאָנדיציאָנירונג בעת רעדאַקטירונג.
controls.trajectory.sparsityאָפּציאָנעל
טיפּnumber | null
0 – 1
זעלטנקייט־באַשטעטיקונג פֿאַר באַוועגונג־טראַדזשעקטאָריע; לאָז אויס צו האַלטן דעם סטאַנדאַרט אָדער פֿאַרגרעסער צו רעדוצירן ווי פֿיל באַוועגונג־אַנקערס ווערן געניצט.
controls.faceאָפּציאָנעל
טיפּobject
קאָנדיציאָנירונג באַזירט אויף פּנים־אידענטיטעט.
controls.face.enabledאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
קנעפּל פֿאַר פּנים־אידענטיטעט־קאָנדיציאָנירונג בעת רעדאַקטירונג.
keyframesאָפּציאָנעל
טיפּstring[]
≤ 64 ייטעמס
מולטי־קי־פֿרעם־רעדאַקטירונג־גיידס צוגעשטעלט ווי בילד־URLs אַנשטאָט start_image_url. צושטעלן קי־פֿרעמס צוזאַמען מיט אַן גלײַכלאַנגן keyframe_indexes אַרריי צו פֿאַרבינדן יעדן בילד מיט זײַן מקור־ווידעא־ראַם־פּאָזיציע; מעגלעך מאַקסימום 64 URLs.
keyframe_indexesאָפּציאָנעל
טיפּinteger[]
≤ 64 ייטעמס
מקור־ראַם־מאַפּינג צוגעפּאַסט איינס־צו־איינס צו קי־פֿרעמס: איינטראָג [i] ספּעציפֿיצירט די אַנקער־פּאָזיציע פֿאַר keyframes[i]. ביידע אַררייס מוזן האָבן גלײַכע לענגען, און פּאָזיציעס מוזן זײַן באַזונדערע און נישט־נעגאַטיוו.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
סקרינינג קען ווערן פאַרלייכטערט דורך שטעלן false, אויב דער רופער איז אָטעריזירט.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 10 MB, אָדער דעם file_url פֿון אַן אַרויפֿלאָד. טעקעס

אויסגאַבע

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"
  }
}
אייער טעקעס, אייער ברירהיעדער outputs[].url איז אַ קאַפּיע אין אונדזער סטאָרידזש: געהאַלטן אויף אייביק (באַצאָלט פּער GB־חודש) אָדער 7 טעג אומזיסט, לויט אײַער חשבון־באַשטעטיקונג אָדער ?storage=.
דער זעלבער פֿאָרעם בײַ יעדן מאָדעלtype, url, content_type, width, height און duration, סײַ פֿאַר בילדער, ווידעאָ און אַודיאָ. output איז דער אייגענער רעזולטאַט־אָביעקט פֿון מאָדעל.
פֿעלדער פֿון דער אויסגאַבע
video
object {url, content_type, file_name, file_size}ווידעא געשאַפֿן דורכן מאָדעל.
exr_file
object {url, content_type, file_name, file_size} | nullEXR סיידקאַר אין דעם פֿאָרעם וואָס Luma עקספּאָרטירט: אָדער איין EXR פֿײַל אָדער אַ ZIP אַרכיוו. ער ווערט גענערירט ווען exr_export איז true.

מער מאָדעלן: ווידעא צו ווידעא

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/luma/agent/ray/v3.2/video-to-video.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt