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

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"

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

الحصول على مفتاح API
Vidu من مرجع إلى فيديو إخراج بدقة 4Kمدخلات مرجعية3–16 ثحتى 4K #reference-to-video#multi-shot

تحويل مرجع 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 أو URIs بيانات base64. تقبل حتى 12 صورة بتنسيق png أو jpeg أو jpg أو webp.

أفلت ملفًا، أو

صوت مرجعي للحفاظ على اتساق الصوت، مقدم كعناوين URL أو URIs بيانات base64. يقبل حتى 3 مقاطع mp3، مدة كل منها 3–12 ثانية وحجمها الأقصى 50 MB.

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

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

يحافظ على اتساق الشخصيات والعناصر والأصوات باستخدام ما يصل إلى 12 من `reference_image_urls` وما يصل إلى 3 مقاطع mp3 في `reference_audio_urls` (مدة كل منها من 3 إلى 12 ثانية). يشير الموجّه، الذي يصل إلى 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 أو URIs بيانات base64. تقبل حتى 12 صورة بتنسيق png أو jpeg أو jpg أو webp.
reference_audio_urlsاختياري
النوعurl[] · audio
صوت مرجعي للحفاظ على اتساق الصوت، مقدم كعناوين URL أو URIs بيانات base64. يقبل حتى 3 مقاطع mp3، مدة كل منها 3–12 ثانية وحجمها الأقصى 50 MB.
durationاختياري
النوعinteger
الافتراضي5
3 – 16
مدة الفيديو بالثواني، من 3 إلى 16.
seedاختياري
النوعinteger | null
بذرة تجعل التوليد قابلًا لإعادة الإنتاج. يؤدي ضبطها على None إلى اختيار بذرة عشوائيًا.
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 هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 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البذرة العشوائية المطبقة أثناء التوليد.

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

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