رفتن به محتوا

Vidu Q4 Reference to Video

یکپارچه‌سازی

شناسه مدل 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"

فایل‌هایی مانند نمونه: ⁨‎$۰٫۳۳۳⁩ ۳۳۳ اعتبار API فایل‌های شما پیش از اجرا اندازه‌گیری می‌شوند اجرای آن در این صفحه

دریافت کلید API
Vidu مرجع به ویدیو خروجی 4Kورودی‌های مرجع۳–۱۶ ثانیهحداکثر 4K #reference-to-video#multi-shot

تبدیل مرجع به ویدیو با Q4، با حداکثر 12 تصویر و 3 کلیپ صوتی، 3-16 ثانیه و حداکثر 4K

Vidu · ویدیو

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

•الزامی 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. حداکثر 12 تصویر در قالب png، jpeg، jpg یا webp پذیرفته می‌شود.

یک فایل بیندازید، یا

صوت مرجع برای حفظ سازگاری صدا، ارائه‌شده به‌صورت URL یا URI دادهٔ base64. حداکثر 3 کلیپ mp3 پذیرفته می‌شود که هرکدام 3–12 ثانیه طول و حداکثر 50 MB حجم دارند.

Seed برای تکرارپذیر کردن تولید. تنظیم آن روی None، Seed را به‌صورت تصادفی انتخاب می‌کند.

POST /run/vidu/q4/reference-to-video?wait=20 قیمت → ⁨‎$۰٫۳۳۳⁩
# 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

با استفاده از حداکثر 12 `reference_image_urls` و حداکثر 3 کلیپ mp3 در `reference_audio_urls` (هرکدام 3-12 ثانیه)، ثبات شخصیت‌ها، اشیا و صداها را حفظ می‌کند. `prompt` با حداکثر 5000 نویسه، به مراجع بر اساس موقعیت اشاره می‌کند. `duration` برابر 3-16 ثانیه، `resolution` حداکثر 4K و `audio` به‌صورت پیش‌فرض خاموش است.

پارامترها

نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نام‌های استاندارد

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
≤ ۵٬۰۰۰ نویسه
پرامپت تولید ویدیو با محدودیت 5000 نویسه. تصاویر مرجع را با جایگاهشان در فهرست، مانند [@reference_image_1] و [@reference_image_2]، و کلیپ‌های صوتی را با [reference_audio_1] و [reference_audio_2] ارجاع دهید و برای ورودی‌های بعدی شماره‌گذاری را ادامه دهید.
reference_image_urlsاختیاری images
نوعurl[] · image
تصاویر مرجع برای حفظ سازگاری سوژه، ارائه‌شده به‌صورت URL یا URI دادهٔ base64. حداکثر 12 تصویر در قالب png، jpeg، jpg یا webp پذیرفته می‌شود.
reference_audio_urlsاختیاری
نوعurl[] · audio
صوت مرجع برای حفظ سازگاری صدا، ارائه‌شده به‌صورت URL یا URI دادهٔ base64. حداکثر 3 کلیپ mp3 پذیرفته می‌شود که هرکدام 3–12 ثانیه طول و حداکثر 50 MB حجم دارند.
durationاختیاری
نوعinteger
پیش‌فرض5
۳ – ۱۶
طول ویدیو برحسب ثانیه، در بازهٔ 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://، یک URI از نوع data: تا سقف 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-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?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بذر تصادفی اعمال‌شده هنگام تولید.

مدل‌های بیشتر: مرجع به ویدیو

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/vidu/q4/reference-to-video.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt