Μετάβαση στο περιεχόμενο

PixVerse Swap

Ενσωμάτωση

id μοντέλου 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/el/developers/models/pixverse/swap.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt