Bỏ qua đến nội dung

PixVerse Swap

Tích hợp

Id mô hình pixverse/swap
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Các tệp như ví dụ: 0,40 $ 400 tín dụng API · ≈ 42,63 ₽ tệp của bạn được đo trước khi chạy Chạy trên trang này

Lấy khóa API
PixVerse · Video

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc video_url
Thả tệp hoặc

URL video bên ngoài cho thao tác thay thế.

•bắt buộc image_url
Thả tệp hoặc

URL hình ảnh đích cho thao tác thay thế.

resolution mặc định 720p

Độ phân giải cho đầu ra; 1080p không khả dụng.

Nâng cao mode · keyframe_id · seed · original_sound_switch · enable_safety_checker
mode mặc định person

Chế độ dùng cho thao tác thay thế.

mặc định 1

ID khung hình ánh xạ khuôn mặt/vật thể, được chọn trong khoảng từ 1 đến (duration_seconds * 24). ID tham chiếu đến đầu vào sau khi chuẩn hóa thành 24 FPS; 1 là khung hình đầu tiên và 24 là khung hình tại giây thứ 1 của video.

Seed điều khiển tính ngẫu nhiên trong quá trình tạo sinh.

POST /run/pixverse/swap?wait=20 báo giá → 0,40 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về PixVerse Swap

Nhận video nguồn và hình ảnh đích, sau đó thay thế hình ảnh theo `mode`: person, object hoặc nền. `keyframe_id` chọn khung hình dùng để ánh xạ, được đếm ở 24 FPS. Độ phân giải đầu ra là 360p, 540p hoặc 720p, còn `original_sound_switch` giữ lại âm thanh gốc.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
video_urlbắt buộc video
Kiểuurl · video
URL video bên ngoài cho thao tác thay thế.
modetùy chọn
Kiểuenum
Mặc địnhperson
personobjectbackground
Chế độ dùng cho thao tác thay thế.
keyframe_idtùy chọn
Kiểuinteger
Mặc định1
≥ 1
ID khung hình ánh xạ khuôn mặt/vật thể, được chọn trong khoảng từ 1 đến (duration_seconds * 24). ID tham chiếu đến đầu vào sau khi chuẩn hóa thành 24 FPS; 1 là khung hình đầu tiên và 24 là khung hình tại giây thứ 1 của video.
image_urlbắt buộc image
Kiểuurl · image
URL hình ảnh đích cho thao tác thay thế.
resolutiontùy chọn
Kiểuenum
Mặc định720p
360p540p720p
Độ phân giải cho đầu ra; 1080p không khả dụng.
seedtùy chọn
Kiểuinteger | null
Seed điều khiển tính ngẫu nhiên trong quá trình tạo sinh.
original_sound_switchtùy chọn
Kiểuboolean
Mặc địnhtrue
Kiểm soát việc giữ lại âm thanh gốc.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Có thể nới lỏng việc kiểm duyệt bằng cách đặt thành false, nếu người gọi được cấp quyền.
bắt buộc Tên chuẩn, cũng được chấp nhận

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
video
object {url, content_type, file_name, file_size}Video tạo ra từ thao tác thay thế.

Thêm mô hình: Hình ảnh sang video

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/pixverse/swap.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt