דילוג לתוכן

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 מזהה את הפריים שנמצא 1 שנייה מתחילת הווידאו.

Seed השולט באקראיות במהלך היצירה.

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 מזהה את הפריים שנמצא 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-חודש) או למשך 7 ימים ללא תשלום, בהתאם להגדרת החשבון או ל־?storage=.
אותו מבנה בכל מודלtype, url, content_type, width, height ו-duration, עבור תמונות, וידאו ואודיו כאחד. output הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
video
object {url, content_type, file_name, file_size}הווידאו שנוצר מפעולת ההחלפה.

מודלים נוספים: תמונה לווידאו

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/pixverse/swap.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt