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

Vidu · Q1 · Reference to Video

التكامل

معرّف النموذج vidu/q1/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/q1/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",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# 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.40 $⁩ 400 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
Vidu من مرجع إلى فيديو مدخلات مرجعية #stylized#transform

توليد فيديو Q1 يحافظ على ثبات الموضوعات باستخدام حتى 7 صور مرجعية، مع موسيقى خلفية اختيارية

Vidu · فيديو

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

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

إنشاء طلب

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

•مطلوب 88 / 1500

نص موجّه توليد الفيديو، بحد أقصى 1500 حرف.

•مطلوب reference_image_urls
أفلت ملفًا، أو

مراجع مظهر الموضوع مقدمة كعناوين URL لصور، بحد أقصى 7 صور لكي يحافظ Q1 على مظهر متسق.

aspect_ratio الافتراضي 16:9

نسبة أبعاد الفيديو الناتج.

متقدم movement_amplitude · seed · bgm
movement_amplitude الافتراضي auto

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

بذرة تتحكم في العشوائية أثناء التوليد.

POST /run/vidu/q1/reference-to-video?wait=20 عرض السعر → ⁨‏0.40 $⁩
# 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/q1/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",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# 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 · Q1 · Reference to Video

ينشئ مقطعًا من `prompt` نصية (بحد أقصى 1500 حرف) و`reference_image_urls` التي تحافظ على ثبات مظهر الموضوع؛ ويدعم حتى 7 صور. اختر 16:9 أو 9:16 أو 1:1 باستخدام `aspect_ratio`، واضبط `movement_amplitude`، وفعل `bgm` لإضافة موسيقى خلفية.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
≤ 1,500 حرف
نص موجّه توليد الفيديو، بحد أقصى 1500 حرف.
reference_image_urlsمطلوب images
النوعurl[] · image
مراجع مظهر الموضوع مقدمة كعناوين URL لصور، بحد أقصى 7 صور لكي يحافظ Q1 على مظهر متسق.
seedاختياري
النوعinteger | null
بذرة تتحكم في العشوائية أثناء التوليد.
aspect_ratioاختياري
النوعenum
الافتراضي16:9
16:99:161:1
نسبة أبعاد الفيديو الناتج.
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/q1/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": 400,
    "usd": "0.40",
    "charged": 400,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "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}مخرج فيديو Q1 توجه فيه الصور المرجعية مظهر الموضوعات للحفاظ على اتساقه.

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

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