Bỏ qua đến nội dung

Scail 2

Tích hợp

Id mô hình scail-2
# 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/scail-2?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",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "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"

Các tệp như ví dụ: 2,00 $ 2.000 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 704p #stylized#transform

Tạo chuyển động cho ảnh nhân vật tham chiếu bằng chuyển động từ video điều khiển, hoặc thay nhân vật vào cảnh gốc

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 đầu ra mong muốn.

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

URL hình ảnh tham chiếu nhân vật cung cấp nhân vật để tạo hoạt ảnh hoặc thay thế một chủ thể; video điều khiển xác định hoạt ảnh hoặc việc thay thế.

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

Cung cấp URL video điều khiển chuyển động, có một người, nhiều người hoặc một động vật.

resolution mặc định 512p

Độ phân giải đầu ra với hướng được xác định tự động theo tỷ lệ khung hình của hình ảnh tham chiếu. Ở hướng ngang, 512p tương ứng với 896x512 và 704p với 1280x704; hướng dọc lần lượt sử dụng 512x896 và 704x1280.

Nâng cao mode · driving_type · subject_type · num_inference_steps · guidance_scale · shift · seed · enable_safety_checker
mode mặc định animation

Chọn cách sử dụng nhân vật tham chiếu: `replacement` giữ nguyên cảnh gốc nhưng thay thế nhân vật cho chủ thể điều khiển; `animation` áp dụng chuyển động điều khiển cho nhân vật.

driving_type mặc định end_to_end

Chuyển động hoạt ảnh lấy trực tiếp từ video điều khiển được SAM3 tạo mặt nạ với `end_to_end`, lựa chọn mặc định và được khuyến nghị để đạt độ ổn định tối đa. Ngoài ra, `pose` sử dụng NLF/DWPose để dựng bộ xương rõ ràng từ video đó, mang lại khả năng kiểm soát tốt hơn với đầu vào khó.

subject_type mặc định human

Lựa chọn chủ thể trong video điều khiển, với `animal` cấu hình lời nhắc phát hiện của SAM3 cho các chủ thể không phải `human`.

mặc định 40

Số bước lấy mẫu khuếch tán. Tăng giá trị này 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 3

Độ dịch lịch nhiễu cho flow matching, với thiết lập được khuyến nghị là 3.0 khi sử dụng 512p.

Seed tạo sinh được đưa vào phản hồi, dù được cung cấp rõ ràng hay được chọn ngẫu nhiên vì đầu vào bị để trống.

POST /run/scail-2?wait=20 báo giá → 2,00 $
# 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/scail-2?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",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "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ề Scail 2

Nhận `image_url` nhân vật tham chiếu và `video_url` điều khiển có người, nhiều người hoặc động vật. Ở chế độ `animation`, nhân vật thực hiện chuyển động điều khiển; ở chế độ `replacement`, nhân vật thay thế chủ thể trong khi vẫn giữ nguyên cảnh. Độ phân giải là 512p hoặc 704p, với hướng khung hình được chọn từ ảnh. `driving_type` có thể dùng điều khiển trực tiếp đầu-cuối hoặc skeleton tư thế cụ thể.

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 đầu ra mong muốn.
image_urlbắt buộc image
Kiểuurl · image
URL hình ảnh tham chiếu nhân vật cung cấp nhân vật để tạo hoạt ảnh hoặc thay thế một chủ thể; video điều khiển xác định hoạt ảnh hoặc việc thay thế.
video_urlbắt buộc video
Kiểuurl · video
Cung cấp URL video điều khiển chuyển động, có một người, nhiều người hoặc một động vật.
modetùy chọn
Kiểuenum
Mặc địnhanimation
animationreplacement
Chọn cách sử dụng nhân vật tham chiếu: `replacement` giữ nguyên cảnh gốc nhưng thay thế nhân vật cho chủ thể điều khiển; `animation` áp dụng chuyển động điều khiển cho nhân vật.
driving_typetùy chọn
Kiểuenum
Mặc địnhend_to_end
end_to_endpose
Chuyển động hoạt ảnh lấy trực tiếp từ video điều khiển được SAM3 tạo mặt nạ với `end_to_end`, lựa chọn mặc định và được khuyến nghị để đạt độ ổn định tối đa. Ngoài ra, `pose` sử dụng NLF/DWPose để dựng bộ xương rõ ràng từ video đó, mang lại khả năng kiểm soát tốt hơn với đầu vào khó.
subject_typetùy chọn
Kiểuenum
Mặc địnhhuman
humananimal
Lựa chọn chủ thể trong video điều khiển, với `animal` cấu hình lời nhắc phát hiện của SAM3 cho các chủ thể không phải `human`.
resolutiontùy chọn
Kiểuenum
Mặc định512p
512p704p
Độ phân giải đầu ra với hướng được xác định tự động theo tỷ lệ khung hình của hình ảnh tham chiếu. Ở hướng ngang, 512p tương ứng với 896x512 và 704p với 1280x704; hướng dọc lần lượt sử dụng 512x896 và 704x1280.
num_inference_stepstùy chọn
Kiểuinteger
Mặc định40
2 – 50
Số bước lấy mẫu khuếch tán. Tăng giá trị này 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.
shifttùy chọn
Kiểunumber
Mặc định3
1 – 10
Độ dịch lịch nhiễu cho flow matching, với thiết lập được khuyến nghị là 3.0 khi sử dụng 512p.
seedtùy chọn
Kiểuinteger | null
Seed tạo sinh được đưa vào phản hồi, dù được cung cấp rõ ràng hay được chọn ngẫu nhiên vì đầu vào bị để trống.
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": "scail-2",
  "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": 2000,
    "usd": "2.00",
    "charged": 2000,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "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
    },
    "seed": 42,
    "preprocessing_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
    },
    "preprocessing_mask_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"
  }
}
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
integerSeed dùng để tạo sinh video.
preprocessing_video
object {url, content_type, file_name, file_size} | nullVideo gỡ lỗi chứa đầu vào điều kiện hóa tư thế Stage-A được cung cấp cho mô hình khuếch tán, chỉ khả dụng khi `output_preprocessing=true`. Nội dung phụ thuộc vào `driving_type`: `end_to_end` sử dụng cảnh quay điều khiển được SAM3 tạo mặt nạ, còn `driving_type=pose` sử dụng bộ xương được dựng bởi NLF/DWPose.
preprocessing_mask_video
object {url, content_type, file_name, file_size} | nullVideo mặt nạ điều khiển Stage-A để gỡ lỗi, chỉ khả dụng khi `output_preprocessing=true`.

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