ข้ามไปยังเนื้อหา

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_*'

แนวทางการแก้ไขหลายคีย์เฟรมที่ระบุเป็น URL รูปภาพแทน start_image_url ระบุคีย์เฟรมพร้อมกับอาร์เรย์ keyframe_indexes ที่มีความยาวเท่ากัน เพื่อกำหนดให้แต่ละรูปภาพตรงกับตำแหน่งเฟรมในวิดีโอต้นฉบับ อนุญาต URL ได้สูงสุด 64 รายการ

ทางเลือกแบบละเอียดกว่า 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"

เรียกใช้คำขอนี้

คีย์ของคุณจะอยู่ในเบราว์เซอร์นี้ โดยส่งไปยัง 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` ใช้เป็นเงื่อนไขทางเลือกได้ รองรับ `keyframes` สูงสุด 64 จุด โดยกำหนดตำแหน่งด้วย `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 รายการ
แนวทางการแก้ไขหลายคีย์เฟรมที่ระบุเป็น URL รูปภาพแทน start_image_url ระบุคีย์เฟรมพร้อมกับอาร์เรย์ keyframe_indexes ที่มีความยาวเท่ากัน เพื่อกำหนดให้แต่ละรูปภาพตรงกับตำแหน่งเฟรมในวิดีโอต้นฉบับ อนุญาต URL ได้สูงสุด 64 รายการ
keyframe_indexesไม่บังคับ
ประเภทinteger[]
≤ 64 รายการ
การจับคู่เฟรมต้นฉบับแบบหนึ่งต่อหนึ่งกับคีย์เฟรม: รายการ [i] ระบุตำแหน่งจุดยึดสำหรับ keyframes[i] อาร์เรย์ทั้งสองต้องมีความยาวเท่ากัน และตำแหน่งต้องไม่ซ้ำกันและไม่เป็นค่าลบ
enable_safety_checkerไม่บังคับ
ประเภทboolean
ค่าเริ่มต้นtrue
สามารถผ่อนปรนการคัดกรองได้โดยตั้งค่าเป็น false หากผู้เรียกมีสิทธิ์
จำเป็น ชื่อมาตรฐาน ซึ่งรองรับเช่นกัน

พารามิเตอร์ไฟล์รับ URL https:// สาธารณะ, 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} | nullไฟล์ EXR ประกอบในรูปแบบที่ Luma ส่งออก: เป็นไฟล์ EXR หนึ่งไฟล์หรือไฟล์เก็บถาวร ZIP โดยจะสร้างขึ้นเมื่อ exr_export เป็น true

โมเดลเพิ่มเติม: วิดีโอเป็นวิดีโอ

สำหรับเอเจนต์ AI: หน้า Markdown นี้อยู่ที่ https://doitong.com/th/developers/models/luma/agent/ray/v3.2/video-to-video.md. โมเดลและคู่มือทั้งหมด: https://doitong.com/developers/llms.txt