Seedance 2.5 — Tạo video (định dạng nguyên bản)

Hỗ trợ đầu vào tham chiếu dạng văn bản, hình ảnh, video và âm thanh, đồng thời trả về trực tiếp ID tác vụ nguyên bản của Volcengine Ark.

Nếu cần sử dụng cấu trúc tác vụ thống nhất của nền tảng, hãy xem API tạo tác vụ theo định dạng nền tảng.

Để kiểm tra bản nháp độ phân giải thấp trước khi tạo video hoàn chỉnh, xem Hướng dẫn tạo video nháp Draft. Bản nháp dùng 480p; video hoàn chỉnh tạo từ bản nháp dùng 1080p.

POST/api/v3/contents/generations/tasks

Tạo tác vụ video bất đồng bộ Seedance 2.5 qua đường dẫn nguyên bản của Volcengine Ark. Các tham số yêu cầu cốt lõi giống đường dẫn tương thích; khi thành công, API trả về ID tác vụ theo định dạng nguyên bản.

Nội dung yêu cầu, giới hạn tư liệu, ràng buộc loại tác vụ và quy tắc định dạng đầu ra giống API tạo tác vụ tương thích.

Xác thực

bearerAuth

Xác thựcBearer <token>

Sử dụng Bearer your-api-key trong Header Authorization.

Vị trí truyền: header

Nội dung yêu cầu

application/json

Tham số tạo video nguyên bản Seedance 2.5.

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

model*string

ID mô hình Seedance 2.5, chẳng hạn doubao-seedance-2-5-260628. Khi gọi API, hãy chọn mô hình mà API Key hiện tại có thể truy cập.

Độ dài1 <= length

content*array<|>

Danh sách đầu vào gồm văn bản, hình ảnh, video, âm thanh hoặc ID tác vụ Draft. Tham chiếu đa phương thức hỗ trợ tối đa 50 tư liệu: 30 ảnh, 10 video và 10 đoạn âm thanh. Mỗi video hoặc đoạn âm thanh dài 2–30 giây; tổng thời lượng mỗi loại không quá 30 giây. Chỉnh sửa yêu cầu video tham chiếu dài 4–30 giây. Hỗ trợ chỉ tham chiếu âm thanh. Không trộn chế độ khung đầu hoặc khung đầu/cuối với tham chiếu đa phương thức.

Tham chiếu tư liệu theo thứ tự mảng bằng @image1, @video1 và @audio1.

Số phần tử1 <= items

draft?boolean

Có tạo video mẫu Draft hay không. Khi là true, phải dùng 480p. Sau khi thành công, dùng content.draft_task.id trong vòng bảy ngày để tạo video chính thức 1080p. Bỏ qua trường này hoặc đặt false khi tạo video chính thức.

omni_reference_task_type?string

Loại tác vụ tham chiếu đa phương thức. auto tự nhận diện; reference tạo từ tham chiếu; edit yêu cầu video tham chiếu, ratio=adaptive và duration=-1; extend yêu cầu video tham chiếu và ratio=adaptive. Chỉ định loại để kiểm tra ràng buộc sớm. Ý định trong lời nhắc vẫn phải khớp loại đã chọn.

Giá trị mặc định"auto"

Giá trị được phép

"auto"
"reference"
"edit"
"extend"

generate_audio?boolean

Có tạo âm thanh phù hợp với hình ảnh hay không. Bật tùy chọn này thường làm tăng thời gian tạo và chi phí.

ratio?string

Tỷ lệ khung hình video. Tác vụ tạo video từ văn bản hoặc tham chiếu đa phương thức có thể chỉ định tỷ lệ hoặc sử dụng adaptive; tác vụ sử dụng khung hình đầu, khung hình đầu và cuối, chỉnh sửa video hay kéo dài video chỉ hỗ trợ adaptive.

Giá trị mặc định"adaptive"

Giá trị được phép

"16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive"

duration?|integer

Thời lượng tạo video, tính bằng giây. Hỗ trợ từ 4 đến 30, hoặc truyền -1 để mô hình tự quyết định. Tác vụ chỉnh sửa video chỉ hỗ trợ -1; tác vụ kéo dài video hỗ trợ từ 4 đến 30 hoặc -1.

Giá trị mặc định-1

resolution?string

Độ phân giải video đầu ra. Hỗ trợ 480p, 720p và 1080p; kích thước pixel thực tế của đầu ra tùy thuộc vào độ phân giải, tỷ lệ khung hình và khả năng của mô hình hiện tại.

Giá trị mặc định"720p"

Giá trị được phép

"480p"
"720p"
"1080p"

output_format?string

Định dạng video đầu ra. mp4 phù hợp với trang web và phân phối thông thường; mov sử dụng H.264, YUV444P và PCM, phù hợp với hậu kỳ như chỉnh màu, tách nền và ghép hình.

Giá trị mặc định"mp4"

Giá trị được phép

"mp4"
"mov"

watermark?boolean

Có thêm watermark hay không. Việc tùy chọn có hiệu lực hay không tùy thuộc vào quyền mô hình và cấu hình dịch vụ.

seed?integer

Seed ngẫu nhiên, có giá trị từ -1 đến 4294967295. Sử dụng cùng seed có thể tăng khả năng tái lập kết quả, nhưng không đảm bảo kết quả hoàn toàn giống nhau.

Phạm vi-1 <= value <= 4294967295

return_last_frame?boolean

Có trả về ảnh khung cuối JPEG không có hình mờ để tạo video liên tiếp hay không.

callback_url?string

URL callback sau khi tác vụ hoàn tất. Nếu không cấu hình, có thể truy vấn định kỳ trạng thái tác vụ qua API truy vấn.

Định dạnguri

safety_identifier?string

Định danh duy nhất, ổn định của người dùng cuối, giúp nhận diện người dùng có thể vi phạm chính sách sử dụng. Nên truyền chuỗi được băm từ tên người dùng, ID người dùng hoặc email để tránh gửi thông tin cá nhân.

Độ dài1 <= length <= 64

execution_expires_after?integer

Thời gian hiệu lực của tác vụ tính từ lúc tạo, tính bằng giây. Sau khoảng thời gian này, tác vụ chưa hoàn tất sẽ chuyển sang trạng thái hết hạn.

Định dạngint32

Phạm vi3600 <= value <= 259200

Giá trị mặc định172800

tools?array<>

Danh sách công cụ mà mô hình có thể gọi, chẳng hạn web_search. Công cụ khả dụng và tham số cụ thể tùy thuộc vào quyền của tài khoản hiện tại.

service_tier?string

Cấp dịch vụ. Seedance 2.5 sử dụng suy luận trực tuyến default, không hỗ trợ flex. Đặt độ ưu tiên hàng đợi bằng tham số priority riêng.

Giá trị mặc định"default"

priority?integer

Độ ưu tiên hàng đợi trong cùng điểm cuối suy luận, từ 0 đến 9. Giá trị cao hơn được ưu tiên; cùng mức được xử lý theo thứ tự gửi. Không ngắt tác vụ đang chạy.

Phạm vi0 <= value <= 9

Giá trị mặc định0

[key: string]?any

Nội dung phản hồi

`application/json`

curl -X POST "https://example.com/api/v3/contents/generations/tasks" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "content": [      {        "type": "text",        "text": "Một chú thỏ trắng bay xuyên qua những đám mây trên máy bay giấy, ánh sáng điện ảnh, máy quay tiến đều về phía trước"      }    ],    "generate_audio": true,    "ratio": "16:9",    "duration": 10,    "resolution": "1080p",    "output_format": "mp4"  }'

{
  "id": "task_xxxxx"
}

Tài liệu chính thức của Volcengine Ark về tạo tác vụ videoXem định nghĩa giao thức upstream và các thay đổi mới nhất về trường của tác vụ tạo video Seedance.

Seedance 2.5 — Tạo video (định dạng nguyên bản)

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400

401

402

429

500

502

`application/json`