Bỏ qua đến nội dung

Luma Ray 3.2 Image to Video

Tích hợp

Id mô hình luma/agent/ray/v3.2/image-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/image-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"
  }'

# 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,15 $ 150 tín dụng API · ≈ 16,10 ₽ Chạy trên trang này

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

Image-to-video Ray 3.2 với khung hình cuối hoặc tối đa 64 khung hình chính, lặp và đầu ra HDR/EXR tùy chọn

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

Mô tả bằng văn bản về cảnh hoặc chuyển động cần tạo.

duration 5 s

Thời lượng video được tạo. Một neo image_url / end_image_url đơn lẻ không hỗ trợ 10s; thời lượng đó yêu cầu nhiều khung hình then chốt được cung cấp qua keyframes / keyframe_indexes.

aspect_ratio mặc định 16:9

Tỷ lệ khung hình của video kết quả.

resolution mặc định 540p

Độ phân giải của video đầu ra.

Nâng cao image · end_image · loop · enable_safety_checker · keyframes · keyframe_indexes
image_url
Thả tệp hoặc

URL hình ảnh khung hình đầu tiên được cung cấp qua image_url, cho phép đi kèm tùy chọn end_image_url. Chế độ neo này loại trừ các khung hình then chốt; chỉ chọn một chế độ, không chọn cả hai.

end_image_url
Thả tệp hoặc

URL hình ảnh khung hình cuối tùy chọn, cho phép nội suy từ image_url đến end_image_url, thay thế cho việc sử dụng các khung hình then chốt.

Cung cấp 1–64 URL hình ảnh làm hướng dẫn image-to-video nhiều khung hình then chốt, ghép với danh sách keyframe_indexes có cùng độ dài để chỉ định vị trí của chúng. Sử dụng keyframes cho phép HDR và tạo sinh 10s, nhưng loại trừ image_url, end_image_url và loop.

Vị trí neo ghép với keyframes: mục [i] xác định vị trí của keyframes[i] trong đầu ra, và hai mảng phải có độ dài bằng nhau. Các vị trí phải khác nhau và không âm; duration × 24fps cho phạm vi 0–120 đối với 5s và 0–240 đối với 10s.

POST /run/luma/agent/ray/v3.2/image-to-video?wait=20 báo giá → 0,15 $
# 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/image-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"
  }'

# 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 Image to Video

Tạo hoạt ảnh từ `image_url` làm khung hình đầu tiên, tùy chọn kèm `end_image_url`, hoặc thay thế bằng `keyframes` cùng `keyframe_indexes` (1 đến 64). Tỷ lệ khung hình từ 3:4 đến 21:9, độ phân giải là 540p, 720p hoặc 1080p, còn `duration` là 5s hoặc 10s; thời lượng 10s yêu cầu khung hình chính. `loop`, `hdr` và `exr_export` khả dụng theo các điều kiện nêu rõ. Lời nhắc giới hạn ở 6000 ký tự.

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ự
Mô tả bằng văn bản về cảnh hoặc chuyển động cần tạo.
image_urltùy chọn image
Kiểuurl · image
URL hình ảnh khung hình đầu tiên được cung cấp qua image_url, cho phép đi kèm tùy chọn end_image_url. Chế độ neo này loại trừ các khung hình then chốt; chỉ chọn một chế độ, không chọn cả hai.
end_image_urltùy chọn end_image
Kiểuurl · image
URL hình ảnh khung hình cuối tùy chọn, cho phép nội suy từ image_url đến end_image_url, thay thế cho việc sử dụng các khung hình then chốt.
aspect_ratiotùy chọn
Kiểuenum
Mặc định16:9
3:44:31:19:1616:921:9
Tỷ lệ khung hình của video kết quả.
resolutiontùy chọn
Kiểuenum
Mặc định540p
540p720p1080p
Độ phân giải của video đầu ra.
durationtùy chọn
Kiểuenum
Mặc định5s
5s10s
Thời lượng video được tạo. Một neo image_url / end_image_url đơn lẻ không hỗ trợ 10s; thời lượng đó yêu cầu nhiều khung hình then chốt được cung cấp qua keyframes / keyframe_indexes.
looptùy chọn
Kiểuboolean
Mặc địnhfalse
Tạo sinh vòng lặp liền mạch, chỉ giới hạn cho đầu ra dải động tiêu chuẩn; chỉ định khung hình cuối hoặc các khung hình then chốt sẽ khiến tùy chọn này không khả dụng.
hdrtùy chọn
Kiểuboolean
Mặc địnhfalse
Mã hóa HDR cho đầu ra MP4, khả dụng ở 720p hoặc 1080p với các tài khoản có quyền truy cập HDR. Phải tắt lặp để sử dụng.
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.
keyframestùy chọn
Kiểustring[]
≤ 64 mục
Cung cấp 1–64 URL hình ảnh làm hướng dẫn image-to-video nhiều khung hình then chốt, ghép với danh sách keyframe_indexes có cùng độ dài để chỉ định vị trí của chúng. Sử dụng keyframes cho phép HDR và tạo sinh 10s, nhưng loại trừ image_url, end_image_url và loop.
keyframe_indexestùy chọn
Kiểuinteger[]
≤ 64 mục
Vị trí neo ghép với keyframes: mục [i] xác định vị trí của keyframes[i] trong đầu ra, và hai mảng phải có độ dài bằng nhau. Các vị trí phải khác nhau và không âm; duration × 24fps cho phạm vi 0–120 đối với 5s và 0–240 đối với 10s.
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/image-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": 150,
    "usd": "0.15",
    "charged": 150,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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: Hình ảnh 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/image-to-video.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt