رفتن به محتوا

Vidu · Q2 · Reference to Video · Pro

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

شناسه مدل vidu/q2/reference-to-video/pro
# 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/q2/reference-to-video/pro?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 مرجع به ویدیو ورودی‌های مرجع۱–۸ ثانیهحداکثر 1080p

تبدیل مرجع به ویدئوی Q2 Pro با تصاویر و حداکثر 2 ویدئوی مرجع، کیفیت 540p تا 1080p و مدت 1 تا 8 ثانیه

Vidu · ویدیو

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

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

ساخت درخواست

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

•الزامی 88 / 2000

دستورهای متنی برای تولید ویدیو، محدود به 2000 نویسه.

resolution پیش‌فرض 720p

وضوح ویدیوی نهایی.

پیش‌فرض 16:9

نسبت عرض به ارتفاع ویدیو را با استفاده از auto، 16:9، 9:16، 1:1 یا مقدار دیگری به‌شکل W:H تنظیم کنید.

پیش‌فرض 4

طول ویدیو برحسب ثانیه؛ مقدار 0 مدت‌زمان خودکار را انتخاب می‌کند.

پیشرفته images · reference_video_urls · movement_amplitude · seed · bgm
reference_image_urls
یک فایل بیندازید، یا

URLهای تصاویر مرجع ظاهر سوژه؛ بدون ورودی ویدیو حداکثر 7 تصویر پذیرفته می‌شود. وجود ویدیوها این تعداد را به 4 تصویر کاهش می‌دهد.

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

ورودی‌های ویدیوی مرجع ارائه‌شده از طریق URL، محدود به 2 مورد؛ این ورودی‌ها یا به‌عنوان محتوای ویرایش یا به‌عنوان مرجع حرکت استفاده می‌شوند.

movement_amplitude پیش‌فرض auto

میزان حرکت شیء درون فریم.

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

POST /run/vidu/q2/reference-to-video/pro?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/q2/reference-to-video/pro?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 · Q2 · Reference to Video · Pro

با پرامپتی حداکثر 2000 نویسه به‌همراه رسانه‌های مرجع، ویدئو تولید می‌کند. `reference_image_urls` حداکثر 7 تصویر، یا در صورت ارائه ویدئو حداکثر 4 تصویر می‌پذیرد؛ `reference_video_urls` نیز برای ویرایش یا مرجع حرکت حداکثر 2 ویدئو می‌پذیرد. `duration` از 1 تا 8 ثانیه، `resolution` برابر 540p، 720p یا 1080p و `aspect_ratio` آزاد است. `bgm` اختیاری است.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
≤ ۲٬۰۰۰ نویسه
دستورهای متنی برای تولید ویدیو، محدود به 2000 نویسه.
reference_image_urlsاختیاری images
نوعurl[] · image
URLهای تصاویر مرجع ظاهر سوژه؛ بدون ورودی ویدیو حداکثر 7 تصویر پذیرفته می‌شود. وجود ویدیوها این تعداد را به 4 تصویر کاهش می‌دهد.
reference_video_urlsاختیاری
نوعurl[] · video
ورودی‌های ویدیوی مرجع ارائه‌شده از طریق URL، محدود به 2 مورد؛ این ورودی‌ها یا به‌عنوان محتوای ویرایش یا به‌عنوان مرجع حرکت استفاده می‌شوند.
seedاختیاری
نوعinteger | null
Seed برای تکرارپذیر کردن تولید. تنظیم آن روی None، Seed را به‌صورت تصادفی انتخاب می‌کند.
durationاختیاری
نوعinteger
پیش‌فرض4
۱ – ۸
طول ویدیو برحسب ثانیه؛ مقدار 0 مدت‌زمان خودکار را انتخاب می‌کند.
resolutionاختیاری
نوعenum
پیش‌فرض720p
540p720p1080p
وضوح ویدیوی نهایی.
aspect_ratioاختیاری
نوعstring
پیش‌فرض16:9
نسبت عرض به ارتفاع ویدیو را با استفاده از auto، 16:9، 9:16، 1:1 یا مقدار دیگری به‌شکل W:H تنظیم کنید.
movement_amplitudeاختیاری
نوعenum
پیش‌فرضauto
autosmallmediumlarge
میزان حرکت شیء درون فریم.
bgmاختیاری
نوعboolean
پیش‌فرضfalse
تعیین می‌کند آیا ویدیوی تولیدشده شامل موسیقی پس‌زمینه باشد یا نه.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

پارامترهای فایل یک URL عمومی https://، یک URI از نوع data: تا سقف 10 MB، یا file_url یک فایل بارگذاری‌شده را می‌پذیرند. فایل‌ها

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "vidu/q2/reference-to-video/pro",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "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
    }
  },
  "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}خروجی ویدیوی Q2 Pro که تولید آن با ارجاع‌های ویدیویی یا تصویری هدایت می‌شود.

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

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