Bỏ qua đến nội dung

Luma Ray 3.2 Video to Video

Tích hợp

Id mô hình 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"

Yêu cầu này: 0,72 $ 720 tín dụng API · ≈ 77,27 ₽ Chạy trên trang này

Lấy khóa API
Luma AI Video sang video Lipsync5–10 stối đa 1080p #stylized#transform

Chỉnh sửa video bằng Ray 3.2, tái định phong cách cho video nguồn với các thiết lập sẵn về cường độ chỉnh sửa, bộ điều khiển và khung hình chính

Luma AI · Video

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc 88 / 6000

Hướng dẫn văn bản để chỉnh sửa video nguồn.

•bắt buộc video_url
Thả tệp hoặc

URL của video cần chỉnh sửa.

duration 5 s

Độ dài video sau khi chỉnh sửa.

resolution mặc định 540p

Độ phân giải đầu ra sau khi chỉnh sửa.

Nâng cao image · user · edit_strength · auto_controls · enable_safety_checker · keyframes · controls · keyframe_indexes
start_image_url
Thả tệp hoặc

Ghi đè khung hình đầu tiên cho video đã chỉnh sửa, được cung cấp dưới dạng URL hình ảnh tùy chọn; khi bỏ qua, mô hình suy ra khung hình đó từ video nguồn. Ví dụ, cung cấp hình ảnh mở đầu đã tạo kiểu lại từ nguồn có thể định hướng diện mạo của bản chỉnh sửa.

ID không trong suốt tùy chọn xác định người dùng cuối gửi yêu cầu.

Cài đặt bảo toàn nguồn cho các bản chỉnh sửa, chỉ khả dụng khi không sử dụng auto_controls; bỏ qua sẽ chọn mặc định của mô hình. Từ thay đổi nhiều nhất đến bám sát nhất, các tùy chọn là 'reimagine_*', 'flex_*' cho kết quả cân bằng và 'adhere_*'.

Hướng dẫn chỉnh sửa nhiều khung hình then chốt được cung cấp dưới dạng URL hình ảnh thay vì start_image_url. Cung cấp keyframes cùng với mảng keyframe_indexes có cùng độ dài để ghim mỗi hình ảnh vào vị trí khung hình tương ứng trong video nguồn; cho phép tối đa 64 URL.

Lựa chọn chi tiết thay thế edit_strength, cấu hình điều kiện hóa riêng cho tư thế, độ sâu, pháp tuyến, quỹ đạo và khuôn mặt. Sử dụng các điều khiển này sẽ loại trừ auto_controls.

Ánh xạ khung hình nguồn ghép một-một với keyframes: mục [i] chỉ định vị trí neo cho keyframes[i]. Hai mảng phải có độ dài bằng nhau và các vị trí phải khác nhau, không âm.

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

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về Luma Ray 3.2 Video to Video

Chỉnh sửa `video_url` theo `prompt`, tùy chọn có `start_image_url` để định hướng khung hình đầu tiên. `edit_strength` cung cấp các mức adhere, flex và reimagine từ 1 đến 3, còn `auto_controls` hoặc đối tượng `controls` cung cấp điều kiện thay thế. Có thể neo tối đa 64 `keyframes` bằng `keyframe_indexes`. Đầu ra từ 540p đến 1080p, dài 5s hoặc 10s, tùy chọn có `hdr` và `exr_export`.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
promptbắt buộc
Kiểustring
≤ 6.000 ký tự
Hướng dẫn văn bản để chỉnh sửa video nguồn.
video_urlbắt buộc video
Kiểuurl · video
URL của video cần chỉnh sửa.
usertùy chọn
Kiểustring | null
ID không trong suốt tùy chọn xác định người dùng cuối gửi yêu cầu.
start_image_urltùy chọn image
Kiểuurl · image
Ghi đè khung hình đầu tiên cho video đã chỉnh sửa, được cung cấp dưới dạng URL hình ảnh tùy chọn; khi bỏ qua, mô hình suy ra khung hình đó từ video nguồn. Ví dụ, cung cấp hình ảnh mở đầu đã tạo kiểu lại từ nguồn có thể định hướng diện mạo của bản chỉnh sửa.
resolutiontùy chọn
Kiểuenum
Mặc định540p
540p720p1080p
Độ phân giải đầu ra sau khi chỉnh sửa.
durationtùy chọn
Kiểuenum
Mặc định5s
5s10s
Độ dài video sau khi chỉnh sửa.
edit_strengthtùy chọn
Kiểuenum
adhere_1adhere_2adhere_3flex_1flex_2flex_3reimagine_1reimagine_2reimagine_3
Cài đặt bảo toàn nguồn cho các bản chỉnh sửa, chỉ khả dụng khi không sử dụng auto_controls; bỏ qua sẽ chọn mặc định của mô hình. Từ thay đổi nhiều nhất đến bám sát nhất, các tùy chọn là 'reimagine_*', 'flex_*' cho kết quả cân bằng và 'adhere_*'.
auto_controlstùy chọn
Kiểuboolean
Mặc địnhfalse
Điều kiện hóa chỉnh sửa tự động: mô hình sử dụng video nguồn để xác định lịch trình thay vì nhận edit_strength cùng với tùy chọn này.
hdrtùy chọn
Kiểuboolean
Mặc địnhfalse
Mã hóa HDR cho đầu ra MP4 ở 720p hoặc 1080p, chỉ khả dụng với các tài khoản có quyền truy cập HDR.
exr_exporttùy chọn
Kiểuboolean
Mặc địnhfalse
Bản xuất EXR bổ sung đi kèm MP4, chỉ khả dụng khi vừa có quyền truy cập HDR vừa có hdr=true.
controlstùy chọn
Kiểuobject
Lựa chọn chi tiết thay thế edit_strength, cấu hình điều kiện hóa riêng cho tư thế, độ sâu, pháp tuyến, quỹ đạo và khuôn mặt. Sử dụng các điều khiển này sẽ loại trừ auto_controls.
controls.posetùy chọn
Kiểuobject
Điều kiện hóa dựa trên tư thế hoặc khung xương.
controls.pose.enabledtùy chọn
Kiểuboolean
Mặc địnhtrue
Công tắc điều kiện hóa tư thế hoặc khung xương trong quá trình chỉnh sửa.
controls.pose.strengthtùy chọn
Kiểuenum
precisecoarse
Lựa chọn độ chính xác điều kiện hóa tư thế: bỏ qua để giữ mặc định, chọn 'coarse' để có nhiều tự do hơn hoặc dùng 'precise' để bám sát tư thế nguồn.
controls.depthtùy chọn
Kiểuobject
Điều kiện hóa dựa trên độ sâu hoặc hình học cảnh.
controls.depth.enabledtùy chọn
Kiểuboolean
Mặc địnhtrue
Công tắc điều kiện hóa độ sâu hoặc hình học cảnh trong quá trình chỉnh sửa.
controls.depth.blurtùy chọn
Kiểunumber | null
0 – 1
Cài đặt làm mờ độ sâu, để trống nhằm giữ mặc định hoặc tăng lên để cho hình học nhiều tự do hơn.
controls.normalstùy chọn
Kiểuobject
Điều kiện hóa dựa trên pháp tuyến bề mặt.
controls.normals.enabledtùy chọn
Kiểuboolean
Mặc địnhtrue
Công tắc điều kiện hóa pháp tuyến bề mặt trong quá trình chỉnh sửa.
controls.normals.augmentationtùy chọn
Kiểunumber | null
0 – 1
Cài đặt tăng cường pháp tuyến bề mặt; bỏ qua để giữ mặc định hoặc tăng lên để cho phép diễn giải lại hình học bề mặt nhiều hơn.
controls.trajectorytùy chọn
Kiểuobject
Điều kiện hóa dựa trên quỹ đạo chuyển động.
controls.trajectory.enabledtùy chọn
Kiểuboolean
Mặc địnhtrue
Công tắc điều kiện hóa quỹ đạo chuyển động trong quá trình chỉnh sửa.
controls.trajectory.sparsitytùy chọn
Kiểunumber | null
0 – 1
Cài đặt độ thưa quỹ đạo chuyển động; bỏ qua để giữ mặc định hoặc tăng lên để giảm số neo chuyển động được sử dụng.
controls.facetùy chọn
Kiểuobject
Điều kiện hóa dựa trên nhận dạng khuôn mặt.
controls.face.enabledtùy chọn
Kiểuboolean
Mặc địnhtrue
Công tắc điều kiện hóa nhận dạng khuôn mặt trong quá trình chỉnh sửa.
keyframestùy chọn
Kiểustring[]
≤ 64 mục
Hướng dẫn chỉnh sửa nhiều khung hình then chốt được cung cấp dưới dạng URL hình ảnh thay vì start_image_url. Cung cấp keyframes cùng với mảng keyframe_indexes có cùng độ dài để ghim mỗi hình ảnh vào vị trí khung hình tương ứng trong video nguồn; cho phép tối đa 64 URL.
keyframe_indexestùy chọn
Kiểuinteger[]
≤ 64 mục
Ánh xạ khung hình nguồn ghép một-một với keyframes: mục [i] chỉ định vị trí neo cho keyframes[i]. Hai mảng phải có độ dài bằng nhau và các vị trí phải khác nhau, không âm.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Có thể nới lỏng việc kiểm duyệt bằng cách đặt thành false, nếu người gọi được cấp quyền.
bắt buộc Tên chuẩn, cũng được chấp nhận

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

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"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
video
object {url, content_type, file_name, file_size}Video do mô hình tạo ra.
exr_file
object {url, content_type, file_name, file_size} | nullTệp EXR đi kèm theo dạng Luma xuất: một tệp EXR hoặc một kho lưu trữ ZIP. Tệp được tạo khi exr_export là true.

Thêm mô hình: Video sang video

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/luma/agent/ray/v3.2/video-to-video.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt