Langkau ke kandungan

PixVerse Swap

Integrasikan

ID model 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"

Fail seperti contoh: $0.40 400 kredit API fail anda diukur sebelum dijalankan Jalankan pada halaman ini

Dapatkan kunci API
PixVerse Imej ke Video sehingga 720p

Alat pertukaran video yang menggantikan seseorang, objek atau latar belakang menggunakan imej sasaran

PixVerse · Video

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan video_url
Lepaskan fail, atau

URL video luaran untuk operasi pertukaran.

•diperlukan image_url
Lepaskan fail, atau

URL imej sasaran untuk operasi pertukaran.

resolution lalai 720p

Resolusi untuk output; 1080p tidak tersedia.

Lanjutan mode · keyframe_id · seed · original_sound_switch · enable_safety_checker
mode lalai person

Mod yang digunakan untuk operasi pertukaran.

lalai 1

ID bingkai pemetaan muka/objek, dipilih dalam julat 1 hingga (duration_seconds * 24). ID merujuk kepada input selepas dinormalkan kepada 24 FPS, jadi 1 mengenal pasti bingkai pertama dan 24 mengenal pasti bingkai pada saat 1 dalam video.

Seed yang mengawal rawak semasa penjanaan.

POST /run/pixverse/swap?wait=20 sebut harga → $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"

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang PixVerse Swap

Menerima video sumber dan imej sasaran, kemudian menukar imej mengikut `mode`: person, object atau latar belakang. `keyframe_id` memilih bingkai untuk pemetaan, dikira pada 24 FPS. Resolusi output ialah 360p, 540p atau 720p, dan `original_sound_switch` mengekalkan audio asal.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
video_urldiperlukan video
Jenisurl · video
URL video luaran untuk operasi pertukaran.
modepilihan
Jenisenum
Lalaiperson
personobjectbackground
Mod yang digunakan untuk operasi pertukaran.
keyframe_idpilihan
Jenisinteger
Lalai1
≥ 1
ID bingkai pemetaan muka/objek, dipilih dalam julat 1 hingga (duration_seconds * 24). ID merujuk kepada input selepas dinormalkan kepada 24 FPS, jadi 1 mengenal pasti bingkai pertama dan 24 mengenal pasti bingkai pada saat 1 dalam video.
image_urldiperlukan image
Jenisurl · image
URL imej sasaran untuk operasi pertukaran.
resolutionpilihan
Jenisenum
Lalai720p
360p540p720p
Resolusi untuk output; 1080p tidak tersedia.
seedpilihan
Jenisinteger | null
Seed yang mengawal rawak semasa penjanaan.
original_sound_switchpilihan
Jenisboolean
Lalaitrue
Mengawal sama ada audio asal dikekalkan.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pemeriksaan boleh dilonggarkan dengan menetapkannya kepada false, jika pemanggil dibenarkan.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

Output

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
video
object {url, content_type, file_name, file_size}Video yang terhasil daripada operasi pertukaran.

Lebih banyak model: Imej ke Video

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/pixverse/swap.md. Semua model dan panduan: https://doitong.com/developers/llms.txt