تخطّي إلى المحتوى

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"

ملفات مثل المثال: ⁨‏0.30 $⁩ 300 رصيد API تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
Vidu من مرجع إلى فيديو مدخلات مرجعية1–8 ثحتى 1080p

تحويل المراجع إلى فيديو باستخدام Q2 Pro، مع الصور وما يصل إلى مقطعي فيديو مرجعيين، بدقة 540p إلى 1080p ومدة 1-8 ثوانٍ

Vidu · فيديو

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب 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

مدى حركة الكائن داخل الإطار.

بذرة تجعل التوليد قابلًا لإعادة الإنتاج. يؤدي ضبطها على None إلى اختيار بذرة عشوائيًا.

POST /run/vidu/q2/reference-to-video/pro?wait=20 عرض السعر → ⁨‏0.30 $⁩
# 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` ما يصل إلى فيديوهين للتحرير أو كمرجع للحركة. تكون `duration` من 1 إلى 8 ثوانٍ، و`resolution` 540p أو 720p أو 1080p، و`aspect_ratio` حرة الصياغة. `bgm` اختيارية.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
≤ 2,000 حرف
تعليمات نصية لتوليد فيديو، بحد أقصى 2000 حرف.
reference_image_urlsاختياري images
النوعurl[] · image
عناوين URL لصور مراجع مظهر الموضوع، بحد أقصى 7 صور دون مدخلات فيديو. يؤدي تضمين الفيديوهات إلى خفض الحد إلى 4 صور.
reference_video_urlsاختياري
النوعurl[] · video
مدخلات فيديو مرجعية مقدمة عبر URL، بحد أقصى 2؛ وتُستخدم إما كمادة للتحرير أو كمراجع للحركة.
seedاختياري
النوعinteger | null
بذرة تجعل التوليد قابلًا لإعادة الإنتاج. يؤدي ضبطها على None إلى اختيار بذرة عشوائيًا.
durationاختياري
النوعinteger
الافتراضي4
1 – 8
مدة الفيديو بالثواني؛ وتحدد القيمة 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 هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
video
object {url, content_type, file_name, file_size}مخرج فيديو Q2 Pro الذي يسترشد توليده بمراجع فيديو أو صورة.

مزيد من النماذج: من مرجع إلى فيديو

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/vidu/q2/reference-to-video/pro.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt