Seedance 2.5 — Tạo video (định dạng nền tảng)

Tạo tác vụ video Seedance 2.5 qua API Video Generations của nền tảng.

Hỗ trợ đầu vào tham chiếu dạng văn bản, hình ảnh, video và âm thanh, dùng để tạo video từ văn bản, từ khung hình đầu hoặc khung hình đầu và cuối, từ tham chiếu đa phương thức, cũng như chỉnh sửa và kéo dài video.

Nếu cần sử dụng trực tiếp cấu trúc yêu cầu của Volcengine Ark, hãy xem API tạo tác vụ theo định dạng nguyên bản.

Để 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/v1/video/generations

Tạo tác vụ video bất đồng bộ Seedance 2.5 qua đường dẫn Video Generations của nền tảng. API trả về đối tượng tác vụ và ID tác vụ để truy vấn kết quả.

Seedance 2.5 hỗ trợ video dài tối đa 30 giây, tối đa 50 tư liệu tham chiếu đa phương thức và đầu ra mp4 hoặc mov. Với tác vụ chỉnh sửa video, ratio phải là adaptive và duration phải là -1.

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 Seedance 2.5. Mỗi loại tác vụ có các ràng buộc khác nhau về vai trò tư liệu, tỷ lệ khung hình và thời lượng.

Đị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/v1/video/generations" \  -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",    "watermark": false  }'

{
  "id": "task_xxxxx",
  "task_id": "task_xxxxx",
  "object": "video",
  "model": "MODEL_ID",
  "status": "queued",
  "progress": 0,
  "created_at": 1786082400
}

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 nền tảng)

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400application/json

401application/json

402application/json

429application/json

500application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`