رفتن به محتوا

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"

فایل‌هایی مانند نمونه: ⁨‎$۰٫۴۰⁩ ۴۰۰ اعتبار API فایل‌های شما پیش از اجرا اندازه‌گیری می‌شوند اجرای آن در این صفحه

دریافت کلید API
PixVerse تصویر به ویدیو حداکثر 720p

ابزار تعویض ویدیو که با استفاده از تصویر هدف، شخص، شیء یا پس‌زمینه را جایگزین می‌کند

PixVerse · ویدیو

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

•الزامی 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 فریم مربوط به 1 ثانیه پس از شروع ویدیو است.

seed کنترل‌کننده تصادفی‌بودن هنگام تولید.

POST /run/pixverse/swap?wait=20 قیمت → ⁨‎$۰٫۴۰⁩
# 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 تا (duration_seconds * 24). شناسه‌ها به ورودی پس از نرمال‌سازی به 24 FPS اشاره می‌کنند؛ بنابراین 1 نخستین فریم و 24 فریم مربوط به 1 ثانیه پس از شروع ویدیو است.
image_urlالزامی image
نوعurl · image
URL تصویر هدف برای عملیات جایگزینی.
resolutionاختیاری
نوعenum
پیش‌فرض720p
360p540p720p
وضوح خروجی؛ 1080p در دسترس نیست.
seedاختیاری
نوعinteger | null
seed کنترل‌کننده تصادفی‌بودن هنگام تولید.
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 کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
video
object {url, content_type, file_name, file_size}ویدیوی حاصل از عملیات جایگزینی.

مدل‌های بیشتر: تصویر به ویدیو

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/pixverse/swap.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt