Bỏ qua đến nội dung

Workflow Utilities Scale Video

Tích hợp

Id mô hình workflow-utilities/scale-video
# 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/workflow-utilities/scale-video?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"
  }'

# 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"

Tối đa 3,60 $ mỗi lần chạy tính phí theo mức sử dụng thực tế, phần còn lại được hoàn tiền Chạy trên trang này

Lấy khóa API
Utility · 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

Cung cấp URL video cần thu phóng hoặc thay đổi kích thước, sử dụng các kích thước chẵn cho cả chiều cao và chiều rộng để đáp ứng yêu cầu của codec video.

Nâng cao mode · pad_color · codec · preset · width · height · crf
mode mặc định stretch

Phương thức thay đổi kích thước: `stretch` buộc dùng các kích thước được yêu cầu và có thể thay đổi tỷ lệ khung hình. `pad` và `crop` đều giữ nguyên tỷ lệ khung hình: `pad` đặt video vừa trong các kích thước được yêu cầu và lấp đầy phần trống bằng màu đã chọn (thêm viền trên dưới hoặc hai bên). `crop` lấp đầy các kích thước được yêu cầu, sau đó cắt ở giữa để khớp kích thước chính xác.

pad_color mặc định black

Màu dùng để đệm trong chế độ `pad`; các chế độ khác bỏ qua giá trị này.

codec mặc định libx264

Chọn codec mã hóa: dùng libx265 (H.265/HEVC) để nén tốt hơn hoặc libx264 (H.264) để tương thích rộng.

preset mặc định fast

Thiết lập định trước điều khiển tốc độ mã hóa. Chọn thiết lập chậm hơn sẽ cải thiện khả năng nén nhưng tăng thời gian mã hóa.

Chiều rộng đầu ra tính bằng pixel, có thể dùng độc lập hoặc cùng với chiều cao; bắt buộc phải có ít nhất một kích thước. Nếu chỉ có chiều rộng, chiều cao sẽ được tự động suy ra mà không thay đổi tỷ lệ khung hình.

Chiều cao đầu ra tính bằng pixel, có thể dùng độc lập hoặc cùng với chiều rộng; bắt buộc phải có ít nhất một kích thước. Nếu chỉ có chiều cao, chiều rộng sẽ được tự động suy ra mà không thay đổi tỷ lệ khung hình.

mặc định 18

Constant Rate Factor điều khiển chất lượng trong phạm vi 0–51; 18 thường cho chất lượng không mất dữ liệu với hầu hết nội dung. Giảm giá trị sẽ cải thiện chất lượng nhưng làm tăng kích thước tệp.

POST /run/workflow-utilities/scale-video?wait=20 báo giá → 3,60 $
# 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/workflow-utilities/scale-video?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"
  }'

# 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ề Workflow Utilities Scale Video

Thay đổi tỷ lệ video theo `width` mục tiêu (tối đa 7680) và/hoặc `height` (tối đa 4320); nếu chỉ cung cấp một giá trị, giá trị còn lại sẽ theo tỷ lệ khung hình. `mode` có thể kéo giãn, thêm đệm (với màu được chọn) hoặc cắt. Mã hóa bằng libx264 hoặc libx265, thiết lập sẵn tốc độ từ ultrafast đến slow và `crf` từ 0 đến 51. Trả về kích thước ban đầu và kích thước mới.

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
Cung cấp URL video cần thu phóng hoặc thay đổi kích thước, sử dụng các kích thước chẵn cho cả chiều cao và chiều rộng để đáp ứng yêu cầu của codec video.
widthtùy chọn
Kiểuinteger | null
2 – 7.680
Chiều rộng đầu ra tính bằng pixel, có thể dùng độc lập hoặc cùng với chiều cao; bắt buộc phải có ít nhất một kích thước. Nếu chỉ có chiều rộng, chiều cao sẽ được tự động suy ra mà không thay đổi tỷ lệ khung hình.
heighttùy chọn
Kiểuinteger | null
2 – 4.320
Chiều cao đầu ra tính bằng pixel, có thể dùng độc lập hoặc cùng với chiều rộng; bắt buộc phải có ít nhất một kích thước. Nếu chỉ có chiều cao, chiều rộng sẽ được tự động suy ra mà không thay đổi tỷ lệ khung hình.
modetùy chọn
Kiểuenum
Mặc địnhstretch
stretchpadcrop
Phương thức thay đổi kích thước: `stretch` buộc dùng các kích thước được yêu cầu và có thể thay đổi tỷ lệ khung hình. `pad` và `crop` đều giữ nguyên tỷ lệ khung hình: `pad` đặt video vừa trong các kích thước được yêu cầu và lấp đầy phần trống bằng màu đã chọn (thêm viền trên dưới hoặc hai bên). `crop` lấp đầy các kích thước được yêu cầu, sau đó cắt ở giữa để khớp kích thước chính xác.
pad_colortùy chọn
Kiểuenum
Mặc địnhblack
blackwhiteredgreenbluegray
Màu dùng để đệm trong chế độ `pad`; các chế độ khác bỏ qua giá trị này.
codectùy chọn
Kiểuenum
Mặc địnhlibx264
libx264libx265
Chọn codec mã hóa: dùng libx265 (H.265/HEVC) để nén tốt hơn hoặc libx264 (H.264) để tương thích rộng.
presettùy chọn
Kiểuenum
Mặc địnhfast
ultrafastfastmediumslow
Thiết lập định trước điều khiển tốc độ mã hóa. Chọn thiết lập chậm hơn sẽ cải thiện khả năng nén nhưng tăng thời gian mã hóa.
crftùy chọn
Kiểuinteger
Mặc định18
0 – 51
Constant Rate Factor điều khiển chất lượng trong phạm vi 0–51; 18 thường cho chất lượng không mất dữ liệu với hầu hết nội dung. Giảm giá trị sẽ cải thiện chất lượng nhưng làm tăng kích thước tệp.
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": "workflow-utilities/scale-video",
  "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": 3600,
    "usd": "3.60",
    "charged": 3600,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "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
    },
    "original_width": 1929,
    "original_height": 1082,
    "scaled_width": 1920,
    "scaled_height": 1080
  },
  "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}Video sau khi thu phóng hoặc thay đổi kích thước.
original_width
integerChiều rộng video gốc, tính bằng pixel.
original_height
integerChiều cao video gốc, tính bằng pixel.
scaled_width
integerChiều rộng video đầu ra, tính bằng pixel.
scaled_height
integerChiều cao video đầu ra, tính bằng pixel.

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/workflow-utilities/scale-video.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt