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

PixVerse Swap

التكامل

معرّف النموذج pixverse/swap
# 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/swap?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image": "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
PixVerse من صورة إلى فيديو حتى 720p

أداة لاستبدال الأشخاص أو العناصر أو الخلفية في فيديو باستخدام صورة هدف

PixVerse · فيديو

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

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

إنشاء طلب

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

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

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

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

عنوان URL للصورة الهدف في عملية الاستبدال.

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

دقة المخرج؛ 1080p غير متاح.

متقدم mode · keyframe_id · seed · original_sound_switch · enable_safety_checker
mode الافتراضي person

الوضع المستخدم في عملية الاستبدال.

الافتراضي 1

معرّف إطار مطابقة الوجه/الكائن، يُختار ضمن 1 إلى (duration_seconds * 24). تشير المعرّفات إلى المدخل بعد تطبيعه إلى 24 FPS، لذا يحدد 1 الإطار الأول ويحدد 24 الإطار الواقع بعد ثانية واحدة من بداية الفيديو.

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

POST /run/pixverse/swap?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/pixverse/swap?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image": "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

حول PixVerse Swap

يأخذ فيديو مصدر وصورة هدف، ثم يستبدل الصورة وفقًا لـ `mode`: person أو object أو خلفية. يحدد `keyframe_id` الإطار المستخدم للمطابقة، ويُحتسب عند 24 FPS. دقة المخرج هي 360p أو 540p أو 720p، وتحافظ `original_sound_switch` على الصوت الأصلي.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
video_urlمطلوب video
النوعurl · video
عنوان URL خارجي للفيديو المستخدم في عملية الاستبدال.
modeاختياري
النوعenum
الافتراضيperson
personobjectbackground
الوضع المستخدم في عملية الاستبدال.
keyframe_idاختياري
النوعinteger
الافتراضي1
≥ 1
معرّف إطار مطابقة الوجه/الكائن، يُختار ضمن 1 إلى (duration_seconds * 24). تشير المعرّفات إلى المدخل بعد تطبيعه إلى 24 FPS، لذا يحدد 1 الإطار الأول ويحدد 24 الإطار الواقع بعد ثانية واحدة من بداية الفيديو.
image_urlمطلوب image
النوعurl · image
عنوان URL للصورة الهدف في عملية الاستبدال.
resolutionاختياري
النوعenum
الافتراضي720p
360p540p720p
دقة المخرج؛ 1080p غير متاح.
seedاختياري
النوعinteger | null
بذرة تتحكم في العشوائية أثناء التوليد.
original_sound_switchاختياري
النوعboolean
الافتراضيtrue
يتحكم في الاحتفاظ بالصوت الأصلي.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "pixverse/swap",
  "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": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image_url": "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}الفيديو الناتج عن عملية الاستبدال.

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

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