Мазмұнға өту

Luma Ray 3.2 Video to Video

Интеграциялау

Модель идентификаторы 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 с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 мекенжайы; көрсетілмесе, модель бұл кадрды бастапқы бейнеден алады. Мысалы, бастапқы бейненің стильдік өңдеуден өткен ашылу кескінін беру өңдеу көрінісін бағыттай алады.

Сұрауды жіберетін соңғы пайдаланушыны анықтайтын қосымша мөлдір емес идентификатор.

Өңдеу кезінде бастапқыны сақтау параметрі; тек auto_controls қолданылмаған кезде қолжетімді. Көрсетілмесе, модельдің әдепкі мәні таңдалады. Ең көп өзгерістен ең жақын сәйкестікке дейінгі опциялар: 'reimagine_*', теңгерімді нәтиже беретін 'flex_*' және 'adhere_*'.

start_image_url орнына кескін URL мекенжайлары түрінде берілетін көп негізгі кадрлы өңдеу нұсқаулықтары. Әр кескінді бастапқы бейнедегі кадр орнына бекіту үшін keyframes параметрін ұзындығы сондай keyframe_indexes массивімен бірге беріңіз; ең көбі 64 URL рұқсат етіледі.

Позаны, тереңдікті, нормальдарды, траекторияны және беттің әрқайсысын бөлек шарттайтын edit_strength параметрінің егжей-тегжейлі баламасы. Бұл басқару элементтерін пайдалану auto_controls параметрін қолдануға жол бермейді.

Keyframes параметрімен бір-біріне сәйкестендірілген бастапқы кадрларды бейнелеу: [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"

Осы сұрауды іске қосу

Кілтіңіз осы браузерде қалады: ол тек Doitong API-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

Luma Ray 3.2 Video to Video туралы

`video_url` мәнін `prompt` бойынша өңдейді, ал бірінші кадрды бағыттау үшін қосымша `start_image_url` беруге болады. `edit_strength` 1-ден 3-ке дейінгі adhere, flex және reimagine деңгейлерін ұсынады, ал `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
Сұрауды жіберетін соңғы пайдаланушыны анықтайтын қосымша мөлдір емес идентификатор.
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
720p немесе 1080p форматындағы MP4 шығысына арналған HDR кодтауы; тек HDR рұқсаты бар аккаунттарға қолжетімді.
exr_exportміндетті емес
Түріboolean
Әдепкіfalse
MP4 файлына қосымша берілетін EXR экспорты; тек 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 элемент
start_image_url орнына кескін URL мекенжайлары түрінде берілетін көп негізгі кадрлы өңдеу нұсқаулықтары. Әр кескінді бастапқы бейнедегі кадр орнына бекіту үшін keyframes параметрін ұзындығы сондай keyframe_indexes массивімен бірге беріңіз; ең көбі 64 URL рұқсат етіледі.
keyframe_indexesміндетті емес
Түріinteger[]
≤ 64 элемент
Keyframes параметрімен бір-біріне сәйкестендірілген бастапқы кадрларды бейнелеу: [i] жазбасы keyframes[i] үшін бекіту орнын көрсетеді. Екі массивтің ұзындығы бірдей, ал орындар қайталанбайтын және теріс емес болуы керек.
enable_safety_checkerміндетті емес
Түріboolean
Әдепкіtrue
Шақырушы авторизацияланған болса, false мәнін орнату арқылы тексеруді жеңілдетуге болады.
міндетті Канондық атау, бұл да қабылданады

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың 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-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдей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} | nullLuma экспорттайтын пішімдегі EXR қосымша файлы: бір EXR файл немесе ZIP мұрағаты. Ол exr_export true болғанда жасалады.

Қосымша модельдер: Бейнеден бейнеге

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/luma/agent/ray/v3.2/video-to-video.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt