Bỏ qua đến nội dung

ID-V2V

Tích hợp

Id mô hình id-v2v
# 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/id-v2v?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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"

Các tệp như ví dụ: 1,013 $ 1.013 tín dụng API 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
Open model Video sang video tối đa 720p #stylized#transform#editing

Biến đổi phong cách video từ khung hình đầu đã chỉnh sửa, đồng thời giữ nhận dạng và chuyển động của chủ thể

Open model · 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

Lời nhắc chỉ định video đã chỉnh sửa mong muốn.

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

Tham chiếu chuyển động và khung hình cho quá trình tạo sinh, được cung cấp dưới dạng URL của video nguồn.

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

Tham chiếu danh tính và phong cách để tạo lại video, được cung cấp dưới dạng URL trỏ đến khung hình đầu tiên đã chỉnh sửa.

resolution mặc định 720p

Chọn 720p cho đầu ra 1280×720 hoặc 720×1280, hoặc 480p cho đầu ra 832×480 hoặc 480×832. Hướng của video nguồn quyết định kích thước nào được áp dụng.

mặc định 81

Giới hạn số khung hình cần tạo; nếu nguồn có ít khung hình hơn, số khung hình của nguồn trở thành giới hạn trên.

Nâng cao segmentation_prompt · num_inference_steps · guidance_scale · vace_scale · seed · enable_safety_checker · keyframes
0 / 100

Lời nhắc chọn chủ thể cho SAM-3, xác định vùng có các pixel dùng để định hướng quá trình tạo sinh. Bên ngoài chủ thể được phân đoạn đó, quá trình tạo sinh không bị ràng buộc.

mặc định 30

Điều khiển chất lượng và tốc độ clip, được biểu thị bằng số bước lấy mẫu khuếch tán cho mỗi clip: nhiều bước hơn cải thiện chất lượng nhưng mất nhiều thời gian hơn.

mặc định 5

Mức độ hướng dẫn không dùng bộ phân loại, cân bằng giữa việc bám sát lời nhắc và tính sáng tạo.

mặc định 1

Mức độ bám sát cấu trúc của video nguồn, được điều chỉnh qua hệ số điều kiện hóa VACE.

Seed ngẫu nhiên được chia sẻ giữa tất cả clip khi tạo nhiều clip, cho phép tái lập quá trình tạo sinh.

Neo danh tính tùy chọn cho video dài: cung cấp các khung hình chính đã chỉnh sửa cùng chỉ số khung hình đầu ra nơi chúng phải xuất hiện.

POST /run/id-v2v?wait=20 báo giá → 1,013 $
# 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/id-v2v?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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"

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ề ID-V2V

Tạo lại video nguồn (`video_url`) theo diện mạo của khung hình đầu đã chỉnh sửa (`image_url`), được điều khiển bằng `prompt`. Có thể dùng tối đa 5 `keyframes` để neo nhận dạng trong các clip dài hơn. Đầu ra là 480p hoặc 720p với `num_frames` từ 17 đến 241; `segmentation_prompt` (mặc định person) chọn chủ thể mà pixel của chủ thể đó dùng để điều kiện hóa kết quả.

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ả
promptbắt buộc
Kiểustring
Lời nhắc chỉ định video đã chỉnh sửa mong muốn.
video_urlbắt buộc video
Kiểuurl · video
Tham chiếu chuyển động và khung hình cho quá trình tạo sinh, được cung cấp dưới dạng URL của video nguồn.
image_urlbắt buộc image
Kiểuurl · image
Tham chiếu danh tính và phong cách để tạo lại video, được cung cấp dưới dạng URL trỏ đến khung hình đầu tiên đã chỉnh sửa.
keyframestùy chọn
Kiểuobject[]
≤ 5 mục
Neo danh tính tùy chọn cho video dài: cung cấp các khung hình chính đã chỉnh sửa cùng chỉ số khung hình đầu ra nơi chúng phải xuất hiện.
keyframes[].image_urlbắt buộc
Kiểuurl · image
URL hình ảnh đã chỉnh sửa cho một neo danh tính trong video dài; tỷ lệ khung hình của hình ảnh không được chênh quá 0.1 so với đầu ra. Hình ảnh xuất hiện nguyên trạng tại `frame_index`.
keyframes[].frame_indexbắt buộc
Kiểuinteger
≥ 1
Đặt khung hình chính ở vị trí đầu ra tối thiểu là 1 và nhỏ hơn tổng số khung hình đầu ra, sử dụng chỉ mục bắt đầu từ 0. Vị trí 0 dành riêng cho khung hình bắt đầu đã chỉnh sửa từ `image_url`.
resolutiontùy chọn
Kiểuenum
Mặc định720p
480p720p
Chọn 720p cho đầu ra 1280×720 hoặc 720×1280, hoặc 480p cho đầu ra 832×480 hoặc 480×832. Hướng của video nguồn quyết định kích thước nào được áp dụng.
num_framestùy chọn
Kiểuinteger
Mặc định81
17 – 241
Giới hạn số khung hình cần tạo; nếu nguồn có ít khung hình hơn, số khung hình của nguồn trở thành giới hạn trên.
segmentation_prompttùy chọn
Kiểustring
Mặc địnhperson
≤ 100 ký tự
Lời nhắc chọn chủ thể cho SAM-3, xác định vùng có các pixel dùng để định hướng quá trình tạo sinh. Bên ngoài chủ thể được phân đoạn đó, quá trình tạo sinh không bị ràng buộc.
num_inference_stepstùy chọn
Kiểuinteger
Mặc định30
2 – 40
Điều khiển chất lượng và tốc độ clip, được biểu thị bằng số bước lấy mẫu khuếch tán cho mỗi clip: nhiều bước hơn cải thiện chất lượng nhưng mất nhiều thời gian hơn.
guidance_scaletùy chọn
Kiểunumber
Mặc định5
1 – 10
Mức độ hướng dẫn không dùng bộ phân loại, cân bằng giữa việc bám sát lời nhắc và tính sáng tạo.
vace_scaletùy chọn
Kiểunumber
Mặc định1
0 – 2
Mức độ bám sát cấu trúc của video nguồn, được điều chỉnh qua hệ số điều kiện hóa VACE.
seedtùy chọn
Kiểuinteger | null
Seed ngẫu nhiên được chia sẻ giữa tất cả clip khi tạo nhiều clip, cho phép tái lập quá trình tạo sinh.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Bật kiểm tra an toàn trên cả đầu vào và đầu ra.
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": "id-v2v",
  "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": 1013,
    "usd": "1.013",
    "charged": 1013,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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
    },
    "seed": 42
  },
  "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"
  }
}
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}Tệp video được tạo sinh.
seed
integerGiá trị seed được áp dụng trong quá trình tạo sinh.

Thêm mô hình: Video sang video

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