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

PixVerse C1 Reference To Video

التكامل

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

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

الحصول على مفتاح API
PixVerse من مرجع إلى فيديو صوت أصليمدخلات مرجعية1–15 ثحتى 1080p #video-generation#reference-to-video#pixverse#character-consistency

فيديو C1 يحافظ على اتساق الشخصيات والخلفيات من خلال ما يصل إلى 7 صور مرجعية

PixVerse · فيديو

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

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

إنشاء طلب

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

•مطلوب

موجّه من مرجع إلى فيديو، حيث يُشار إلى المراجع المُحمّلة باستخدام @ref_name. قد يتجاوز النص القصير بصريًا الحد الأقصى البالغ 2048 بايتًا بترميز UTF-8: تشغل الرموز التعبيرية والأحرف ذات علامات التشكيل والأحرف غير اللاتينية عدة بايتات لكل منها، لذا ينطبق الحد على الحجم المشفّر لا على عدد الأحرف.

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

نسبة أبعاد فيديو المخرج.

resolution الافتراضي 720p

دقة فيديو المخرج.

الافتراضي 5

طول الفيديو المُولّد، من 1 إلى 15 ثانية.

•مطلوب

صور مرجعية مزودة بنوع وref_name لكل إدخال، ما يجعل بالإمكان عنونة كل صورة في الموجّه عبر @ref_name.

متقدم seed · enable_safety_checker

بذرة لتوليد فيديو قابل للتكرار. تتطلب الإعادة الدقيقة في كل تشغيل عدم تغيير إصدار النموذج والموجّه والبذرة.

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

# 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

حول PixVerse C1 Reference To Video

ينشئ فيديو من 1 إلى 7 إدخالات في `image_references`، يحتوي كل منها على نوع واسم. استخدم `@ref_name` في `prompt` للإشارة إلى مرجع. يدعم ثماني نسب أبعاد، منها 21:9 و2:3، ودقة تصل إلى 1080p، ومددًا من 1 إلى 15 ثانية، وصوتًا مولّدًا اختياريًا.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
موجّه من مرجع إلى فيديو، حيث يُشار إلى المراجع المُحمّلة باستخدام @ref_name. قد يتجاوز النص القصير بصريًا الحد الأقصى البالغ 2048 بايتًا بترميز UTF-8: تشغل الرموز التعبيرية والأحرف ذات علامات التشكيل والأحرف غير اللاتينية عدة بايتات لكل منها، لذا ينطبق الحد على الحجم المشفّر لا على عدد الأحرف.
aspect_ratioاختياري
النوعenum
الافتراضي16:9
16:94:31:13:49:162:33:221:9
نسبة أبعاد فيديو المخرج.
resolutionاختياري
النوعenum
الافتراضي720p
360p540p720p1080p
دقة فيديو المخرج.
durationاختياري
النوعinteger
الافتراضي5
1 – 15
طول الفيديو المُولّد، من 1 إلى 15 ثانية.
seedاختياري
النوعinteger | null
بذرة لتوليد فيديو قابل للتكرار. تتطلب الإعادة الدقيقة في كل تشغيل عدم تغيير إصدار النموذج والموجّه والبذرة.
generate_audio_switchاختياري generate_audio
النوعboolean
الافتراضيfalse
مفتاح تبديل لتوليد الصوت، للموسيقى الخلفية والمؤثرات الصوتية والحوار.
image_referencesمطلوب
النوعobject[]
≤ 7 عناصر
صور مرجعية مزودة بنوع وref_name لكل إدخال، ما يجعل بالإمكان عنونة كل صورة في الموجّه عبر @ref_name.
image_references[].image_urlمطلوب
النوعurl · image
عنوان URL للصورة المرجعية.
image_references[].typeاختياري
النوعenum
الافتراضيsubject
subjectbackground
فئة المرجع: يحدد 'subject' شخصية أو كائنًا، بينما يحدد 'background' مشهدًا أو بيئة.
image_references[].ref_nameمطلوب
النوعstring
معرّف المرجع (ref_name): اختر اسمًا قصيرًا يتيح للموجّه عنونة هذه الصورة بصيغة @ref_name.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
مطلوب الاسم الأساسي، مقبول أيضًا

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "pixverse/c1/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": 250,
    "usd": "0.25",
    "charged": 250,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_references": [
      {
        "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
        "ref_name": "character"
      }
    ]
  },
  "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}ملف الفيديو الناتج عن التوليد.

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

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