Bỏ qua đến nội dung

Vidu Q4 Reference to Video

Tích hợp

Id mô hình vidu/q4/reference-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/vidu/q4/reference-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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Các tệp như ví dụ: 0,333 $ 333 tín dụng API tệp của bạn được đo trước khi chạy Chạy trên trang này

Lấy khóa API
Vidu Tham chiếu sang video Đầu ra 4KĐầu vào tham chiếu3–16 stối đa 4K #reference-to-video#multi-shot

Chuyển tham chiếu thành video Q4 với tối đa 12 hình ảnh và 3 đoạn thoại, 3-16 giây, tối đa 4K

Vidu · 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 / 5000

Lời nhắc tạo video, giới hạn 5000 ký tự. Tham chiếu hình ảnh bằng vị trí trong danh sách, chẳng hạn [@reference_image_1] và [@reference_image_2]; với đoạn âm thanh, sử dụng [reference_audio_1] và [reference_audio_2], tiếp tục đánh số cho các mục sau.

aspect_ratio mặc định 16:9

Tỷ lệ khung hình của video đầu ra.

resolution mặc định 720p

Độ phân giải của video kết quả.

mặc định 5

Độ dài video tính bằng giây, trong khoảng từ 3 đến 16.

Nâng cao images · reference_audio_urls · seed · audio · enable_safety_checker
reference_image_urls
Thả tệp hoặc

Hình ảnh tham chiếu để duy trì tính nhất quán của chủ thể, được cung cấp dưới dạng URL hoặc URI dữ liệu base64. Chấp nhận tối đa 12 hình ảnh ở định dạng png, jpeg, jpg hoặc webp.

Thả tệp hoặc

Âm thanh tham chiếu để duy trì tính nhất quán của giọng nói, được cung cấp dưới dạng URL hoặc URI dữ liệu base64. Chấp nhận tối đa 3 đoạn mp3, mỗi đoạn dài 3–12 giây và có kích thước tối đa 50 MB.

Seed giúp quá trình tạo sinh có thể tái lập. Đặt thành None sẽ chọn seed ngẫu nhiên.

POST /run/vidu/q4/reference-to-video?wait=20 báo giá → 0,333 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/vidu/q4/reference-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.com/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ề Vidu Q4 Reference to Video

Giữ nhất quán nhân vật, vật thể và giọng nói bằng tối đa 12 `reference_image_urls` và tối đa 3 đoạn mp3 trong `reference_audio_urls` (mỗi đoạn dài 3-12 giây). Lời nhắc tối đa 5000 ký tự tham chiếu đến các tham chiếu theo vị trí. `duration` từ 3-16 giây, `resolution` tối đa 4K và `audio` mặc định tắ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
≤ 5.000 ký tự
Lời nhắc tạo video, giới hạn 5000 ký tự. Tham chiếu hình ảnh bằng vị trí trong danh sách, chẳng hạn [@reference_image_1] và [@reference_image_2]; với đoạn âm thanh, sử dụng [reference_audio_1] và [reference_audio_2], tiếp tục đánh số cho các mục sau.
reference_image_urlstùy chọn images
Kiểuurl[] · image
Hình ảnh tham chiếu để duy trì tính nhất quán của chủ thể, được cung cấp dưới dạng URL hoặc URI dữ liệu base64. Chấp nhận tối đa 12 hình ảnh ở định dạng png, jpeg, jpg hoặc webp.
reference_audio_urlstùy chọn
Kiểuurl[] · audio
Âm thanh tham chiếu để duy trì tính nhất quán của giọng nói, được cung cấp dưới dạng URL hoặc URI dữ liệu base64. Chấp nhận tối đa 3 đoạn mp3, mỗi đoạn dài 3–12 giây và có kích thước tối đa 50 MB.
durationtùy chọn
Kiểuinteger
Mặc định5
3 – 16
Độ dài video tính bằng giây, trong khoảng từ 3 đến 16.
seedtùy chọn
Kiểuinteger | null
Seed giúp quá trình tạo sinh có thể tái lập. Đặt thành None sẽ chọn seed ngẫu nhiên.
aspect_ratiotùy chọn
Kiểuenum
Mặc định16:9
16:99:164:33:41:1
Tỷ lệ khung hình của video đầu ra.
resolutiontùy chọn
Kiểuenum
Mặc định720p
540p720p1080p2K4K
Độ phân giải của video kết quả.
audiotùy chọn
Kiểuboolean
Mặc địnhfalse
Bật/tắt nhạc nền video: false giữ kết quả im lặng; bật tùy chọn này sẽ tạo lời thoại và hiệu ứng âm thanh cùng với video.
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": "vidu/q4/reference-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": 333,
    "usd": "0.333",
    "charged": 333,
    "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
    },
    "cover_image": {
      "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,
      "width": 1024,
      "height": 768
    },
    "seed": 42
  },
  "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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 Q4 Preview tạo bằng các tham chiếu.
cover_image
object {url, content_type, file_name, file_size, width, height} | nullHình ảnh bìa của video kết quả.
seed
integerSeed ngẫu nhiên được áp dụng trong quá trình tạo sinh.

Thêm mô hình: Tham chiếu sang video

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