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

Vidu Q4 Reference to Video

ผสานการทำงาน

ID โมเดล 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"

ไฟล์เช่นเดียวกับตัวอย่าง: $0.333 333 เครดิต API ไฟล์ของคุณจะถูกวัดก่อนเรียกใช้ เรียกใช้ในหน้านี้

รับคีย์ API
Vidu ภาพอ้างอิงเป็นวิดีโอ เอาต์พุต 4Kอินพุตอ้างอิง3–16 sสูงสุด 4K #reference-to-video#multi-shot

reference-to-video รุ่น Q4 โดยใช้ภาพสูงสุด 12 ภาพและคลิปเสียง 3 คลิป ความยาว 3-16 วินาที สูงสุด 4K

Vidu · วิดีโอ

ผลลัพธ์แรกของคุณจะแสดงที่นี่

สร้างคำขอด้านล่างและเรียกใช้ด้วยคีย์ API ของคุณ เอาต์พุตจะถูกคัดลอกไปยังพื้นที่จัดเก็บของเรา และเก็บไว้ตลอดไปหรือฟรี 7 วัน

สร้างคำขอ

ตัวควบคุมสร้างจากสคีมาของโมเดล โค้ดและราคาจะอัปเดตเมื่อคุณเปลี่ยนค่า

•จำเป็น 88 / 5000

พรอมต์สำหรับการสร้างวิดีโอ จำกัดไม่เกิน 5000 อักขระ อ้างอิงรูปภาพตามตำแหน่งในรายการ เช่น [@reference_image_1] และ [@reference_image_2] สำหรับคลิปเสียง ให้ใช้ [reference_audio_1] และ [reference_audio_2] และเพิ่มหมายเลขต่อไปสำหรับรายการถัดไป

aspect_ratio ค่าเริ่มต้น 16:9

อัตราส่วนภาพของวิดีโอเอาต์พุต

resolution ค่าเริ่มต้น 720p

ความละเอียดของวิดีโอผลลัพธ์

ค่าเริ่มต้น 5

ความยาววิดีโอเป็นวินาที อยู่ในช่วง 3 ถึง 16

ขั้นสูง images · reference_audio_urls · seed · audio · enable_safety_checker
reference_image_urls
วางไฟล์ หรือ

รูปภาพอ้างอิงเพื่อรักษาความสม่ำเสมอของวัตถุ ระบุเป็น URL หรือ URI ข้อมูล base64 รองรับรูปภาพ png, jpeg, jpg หรือ webp สูงสุด 12 รูป

วางไฟล์ หรือ

เสียงอ้างอิงเพื่อรักษาความสม่ำเสมอของเสียงพูด ระบุเป็น URL หรือ URI ข้อมูล base64 รองรับคลิป mp3 สูงสุด 3 คลิป แต่ละคลิปยาว 3–12 วินาที และมีขนาดสูงสุด 50 MB

Seed ที่ทำให้การสร้างได้ผลลัพธ์ซ้ำเดิม การตั้งค่าเป็น None จะสุ่มเลือก seed

POST /run/vidu/q4/reference-to-video?wait=20 ใบเสนอราคา → $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"

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

คีย์ของคุณจะอยู่ในเบราว์เซอร์นี้ โดยส่งไปยัง Doitong API เท่านั้น และจะบันทึกใน localStorage ก็ต่อเมื่อคุณเลือกจดจำ รับคีย์ API

เกี่ยวกับ Vidu Q4 Reference to Video

รักษาความสอดคล้องของตัวละคร วัตถุ และเสียง โดยใช้ `reference_image_urls` สูงสุด 12 รายการและคลิป mp3 สูงสุด 3 คลิปใน `reference_audio_urls` (คลิปละ 3-12 วินาที) `prompt` ที่มีความยาวไม่เกิน 5000 อักขระจะอ้างอิงภาพตามตำแหน่ง `duration` อยู่ที่ 3-16 วินาที `resolution` สูงสุด 4K และ `audio` ปิดอยู่โดยค่าเริ่มต้น

พารามิเตอร์

ส่งชื่อมาตรฐานหรือชื่อดั้งเดิมอย่างใดอย่างหนึ่งเท่านั้น ห้ามส่งทั้งสองชื่อ ชื่อมาตรฐาน

ชื่อประเภท ค่าเริ่มต้นค่าที่อนุญาต คำอธิบาย
promptจำเป็น
ประเภทstring
≤ 5,000 อักขระ
พรอมต์สำหรับการสร้างวิดีโอ จำกัดไม่เกิน 5000 อักขระ อ้างอิงรูปภาพตามตำแหน่งในรายการ เช่น [@reference_image_1] และ [@reference_image_2] สำหรับคลิปเสียง ให้ใช้ [reference_audio_1] และ [reference_audio_2] และเพิ่มหมายเลขต่อไปสำหรับรายการถัดไป
reference_image_urlsไม่บังคับ images
ประเภทurl[] · image
รูปภาพอ้างอิงเพื่อรักษาความสม่ำเสมอของวัตถุ ระบุเป็น URL หรือ URI ข้อมูล base64 รองรับรูปภาพ png, jpeg, jpg หรือ webp สูงสุด 12 รูป
reference_audio_urlsไม่บังคับ
ประเภทurl[] · audio
เสียงอ้างอิงเพื่อรักษาความสม่ำเสมอของเสียงพูด ระบุเป็น URL หรือ URI ข้อมูล base64 รองรับคลิป mp3 สูงสุด 3 คลิป แต่ละคลิปยาว 3–12 วินาที และมีขนาดสูงสุด 50 MB
durationไม่บังคับ
ประเภทinteger
ค่าเริ่มต้น5
3 – 16
ความยาววิดีโอเป็นวินาที อยู่ในช่วง 3 ถึง 16
seedไม่บังคับ
ประเภทinteger | null
Seed ที่ทำให้การสร้างได้ผลลัพธ์ซ้ำเดิม การตั้งค่าเป็น None จะสุ่มเลือก seed
aspect_ratioไม่บังคับ
ประเภทenum
ค่าเริ่มต้น16:9
16:99:164:33:41:1
อัตราส่วนภาพของวิดีโอเอาต์พุต
resolutionไม่บังคับ
ประเภทenum
ค่าเริ่มต้น720p
540p720p1080p2K4K
ความละเอียดของวิดีโอผลลัพธ์
audioไม่บังคับ
ประเภทboolean
ค่าเริ่มต้นfalse
ตัวเลือกเสียงประกอบวิดีโอ: false จะทำให้ผลลัพธ์ไม่มีเสียง ส่วนการเปิดใช้จะสร้างบทสนทนาและเอฟเฟกต์เสียงไปพร้อมกับวิดีโอ
enable_safety_checkerไม่บังคับ
ประเภทboolean
ค่าเริ่มต้นtrue
สามารถผ่อนปรนการคัดกรองได้โดยตั้งค่าเป็น false หากผู้เรียกมีสิทธิ์
จำเป็น ชื่อมาตรฐาน ซึ่งรองรับเช่นกัน

พารามิเตอร์ไฟล์รับ URL https:// สาธารณะ, data: URI ขนาดไม่เกิน 10 MB หรือ file_url ของไฟล์ที่อัปโหลด ไฟล์

เอาต์พุต

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"
  }
}
ไฟล์ของคุณ คุณเลือกเองทุก outputs[].url คือสำเนาบนพื้นที่จัดเก็บของเรา: เก็บไว้ตลอดไป (คิดค่าบริการต่อ GB-เดือน) หรือฟรี 7 วัน โดยกำหนดได้ในการตั้งค่าบัญชีหรือ ?storage=
รูปแบบเดียวกันในทุกโมเดลtype, url, content_type, width, height และ duration สำหรับภาพ วิดีโอ และเสียงเหมือนกันทั้งหมด ส่วน output คือออบเจ็กต์ผลลัพธ์ของโมเดลเอง
ฟิลด์ของเอาต์พุต
video
object {url, content_type, file_name, file_size}วิดีโอที่สร้างโดยโมเดล Q4 Preview โดยใช้ข้อมูลอ้างอิง
cover_image
object {url, content_type, file_name, file_size, width, height} | nullรูปภาพปกสำหรับวิดีโอผลลัพธ์
seed
integerซีดสุ่มที่ใช้ระหว่างการสร้าง

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

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