Langkau ke kandungan

Luma Ray 3.2 Video to Video

Integrasikan

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

Permintaan ini: $0.72 720 kredit API · ≈ ₽77.27 Jalankan pada halaman ini

Dapatkan kunci API
Luma AI Video ke Video Lip-sync5–10 ssehingga 1080p #stylized#transform#lipsync

Penyuntingan video Ray 3.2 yang menukar gaya video sumber dengan pratetap kekuatan suntingan, kawalan dan bingkai utama

Luma AI · Video

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan 88 / 6000

Arahan teks untuk menyunting video sumber.

•diperlukan video_url
Lepaskan fail, atau

URL untuk video yang hendak disunting.

duration 5 s

Panjang video selepas penyuntingan.

resolution lalai 540p

Resolusi output selepas penyuntingan.

Lanjutan image · user · edit_strength · auto_controls · enable_safety_checker · keyframes · controls · keyframe_indexes
start_image_url
Lepaskan fail, atau

Penggantian bingkai pertama untuk video yang disunting, dibekalkan sebagai URL imej pilihan; jika diabaikan, model memperoleh bingkai tersebut daripada video sumber. Contohnya, membekalkan imej pembukaan yang diubah gayanya daripada sumber boleh membimbing penampilan suntingan.

ID legap pilihan yang mengenal pasti pengguna akhir yang menghantar permintaan.

Tetapan pengekalan sumber untuk suntingan, hanya tersedia apabila auto_controls tidak digunakan; pengabaian memilih lalai model. Daripada penyimpangan terbesar kepada pematuhan paling hampir, pilihannya ialah 'reimagine_*', 'flex_*' untuk hasil seimbang dan 'adhere_*'.

Panduan penyuntingan berbilang bingkai utama yang dibekalkan sebagai URL imej dan bukannya start_image_url. Bekalkan keyframes bersama tatasusunan keyframe_indexes yang sama panjang untuk menetapkan setiap imej kepada kedudukan bingkai video sumbernya; maksimum 64 URL dibenarkan.

Alternatif terperinci kepada edit_strength yang mengkonfigurasi pengkondisian secara berasingan untuk pose, kedalaman, normal, trajektori dan wajah. Menggunakan kawalan ini tidak membenarkan auto_controls.

Pemetaan bingkai sumber yang digandingkan satu dengan satu bersama keyframes: entri [i] menentukan kedudukan penambat untuk keyframes[i]. Kedua-dua tatasusunan mesti mempunyai panjang yang sama, dan kedudukan mesti berbeza serta tidak negatif.

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

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Luma Ray 3.2 Video to Video

Menyunting `video_url` mengikut `prompt`, dengan `start_image_url` pilihan untuk memandu bingkai pertama. `edit_strength` menawarkan tahap adhere, flex dan reimagine 1 hingga 3, manakala `auto_controls` atau objek `controls` memberikan pengkondisian alternatif. Sehingga 64 `keyframes` boleh ditambat dengan `keyframe_indexes`. Output ialah 540p hingga 1080p, 5s atau 10s, dengan `hdr` dan `exr_export` pilihan.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
promptdiperlukan
Jenisstring
≤ 6,000 aksara
Arahan teks untuk menyunting video sumber.
video_urldiperlukan video
Jenisurl · video
URL untuk video yang hendak disunting.
userpilihan
Jenisstring | null
ID legap pilihan yang mengenal pasti pengguna akhir yang menghantar permintaan.
start_image_urlpilihan image
Jenisurl · image
Penggantian bingkai pertama untuk video yang disunting, dibekalkan sebagai URL imej pilihan; jika diabaikan, model memperoleh bingkai tersebut daripada video sumber. Contohnya, membekalkan imej pembukaan yang diubah gayanya daripada sumber boleh membimbing penampilan suntingan.
resolutionpilihan
Jenisenum
Lalai540p
540p720p1080p
Resolusi output selepas penyuntingan.
durationpilihan
Jenisenum
Lalai5s
5s10s
Panjang video selepas penyuntingan.
edit_strengthpilihan
Jenisenum
adhere_1adhere_2adhere_3flex_1flex_2flex_3reimagine_1reimagine_2reimagine_3
Tetapan pengekalan sumber untuk suntingan, hanya tersedia apabila auto_controls tidak digunakan; pengabaian memilih lalai model. Daripada penyimpangan terbesar kepada pematuhan paling hampir, pilihannya ialah 'reimagine_*', 'flex_*' untuk hasil seimbang dan 'adhere_*'.
auto_controlspilihan
Jenisboolean
Lalaifalse
Pengkondisian suntingan automatik: model menggunakan video sumber untuk menentukan jadual dan bukannya menerima edit_strength bersama pilihan ini.
hdrpilihan
Jenisboolean
Lalaifalse
Pengekodan HDR untuk output MP4 pada 720p atau 1080p, hanya tersedia kepada akaun dengan akses HDR.
exr_exportpilihan
Jenisboolean
Lalaifalse
Eksport EXR tambahan yang disertakan bersama MP4, hanya tersedia dengan akses HDR dan hdr=true.
controlspilihan
Jenisobject
Alternatif terperinci kepada edit_strength yang mengkonfigurasi pengkondisian secara berasingan untuk pose, kedalaman, normal, trajektori dan wajah. Menggunakan kawalan ini tidak membenarkan auto_controls.
controls.posepilihan
Jenisobject
Pengkondisian berdasarkan pose atau rangka.
controls.pose.enabledpilihan
Jenisboolean
Lalaitrue
Suis pengkondisian pose atau rangka semasa penyuntingan.
controls.pose.strengthpilihan
Jenisenum
precisecoarse
Pemilihan ketepatan pengkondisian pose: kekalkan lalai dengan mengabaikannya, pilih 'coarse' untuk kebebasan lebih besar, atau gunakan 'precise' untuk menjejak pose sumber dengan rapat.
controls.depthpilihan
Jenisobject
Pengkondisian berdasarkan kedalaman atau geometri adegan.
controls.depth.enabledpilihan
Jenisboolean
Lalaitrue
Suis pengkondisian kedalaman atau geometri adegan semasa penyuntingan.
controls.depth.blurpilihan
Jenisnumber | null
0 – 1
Tetapan kabur kedalaman, dibiarkan tidak ditentukan untuk mengekalkan lalai atau dinaikkan bagi memberikan geometri kebebasan lebih besar.
controls.normalspilihan
Jenisobject
Pengkondisian berdasarkan normal permukaan.
controls.normals.enabledpilihan
Jenisboolean
Lalaitrue
Suis pengkondisian normal permukaan semasa penyuntingan.
controls.normals.augmentationpilihan
Jenisnumber | null
0 – 1
Tetapan penambahan normal permukaan; kekalkan lalai dengan mengabaikannya atau naikkan untuk membenarkan tafsiran semula geometri permukaan yang lebih besar.
controls.trajectorypilihan
Jenisobject
Pengkondisian berdasarkan trajektori gerakan.
controls.trajectory.enabledpilihan
Jenisboolean
Lalaitrue
Suis pengkondisian trajektori gerakan semasa penyuntingan.
controls.trajectory.sparsitypilihan
Jenisnumber | null
0 – 1
Tetapan jarang trajektori gerakan; abaikannya untuk mengekalkan lalai atau naikkan untuk mengurangkan bilangan penambat gerakan yang digunakan.
controls.facepilihan
Jenisobject
Pengkondisian berdasarkan identiti wajah.
controls.face.enabledpilihan
Jenisboolean
Lalaitrue
Suis pengkondisian identiti wajah semasa penyuntingan.
keyframespilihan
Jenisstring[]
≤ 64 item
Panduan penyuntingan berbilang bingkai utama yang dibekalkan sebagai URL imej dan bukannya start_image_url. Bekalkan keyframes bersama tatasusunan keyframe_indexes yang sama panjang untuk menetapkan setiap imej kepada kedudukan bingkai video sumbernya; maksimum 64 URL dibenarkan.
keyframe_indexespilihan
Jenisinteger[]
≤ 64 item
Pemetaan bingkai sumber yang digandingkan satu dengan satu bersama keyframes: entri [i] menentukan kedudukan penambat untuk keyframes[i]. Kedua-dua tatasusunan mesti mempunyai panjang yang sama, dan kedudukan mesti berbeza serta tidak negatif.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pemeriksaan boleh dilonggarkan dengan menetapkannya kepada false, jika pemanggil dibenarkan.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

Output

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
video
object {url, content_type, file_name, file_size}Video yang dihasilkan oleh model.
exr_file
object {url, content_type, file_name, file_size} | nullFail sampingan EXR dalam bentuk eksport Luma: sama ada satu fail EXR atau arkib ZIP. Ia dijana apabila exr_export ialah true.

Lebih banyak model: Video ke Video

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/luma/agent/ray/v3.2/video-to-video.md. Semua model dan panduan: https://doitong.com/developers/llms.txt