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

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

Hỗ trợ đầu vào văn bản, hình ảnh, video và âm thanh, dùng để tạo video từ văn bản, điều khiển bằng khung hình đầu hoặc khung hình đầu và cuối, cũng như tạo video từ tư liệu tham chiếu.

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.

Seedance 2.0 tiêu chuẩn hỗ trợ 480p/720p/1080p/4k; Seedance 2.0 fast chỉ hỗ trợ 480p/720p. Chọn độ phân giải theo mô hình thực tế.

POST/v1/video/generations

Tạo tác vụ tạo video bất đồng bộ. Khi gửi thành công, API trả về ID tác vụ; video không được trả về đồng bộ qua API này.

Hỗ trợ các mô hình như doubao-seedance-2-0-260128 và doubao-seedance-2-0-fast-260128. Mô hình khả dụng thực tế tùy thuộc vào danh sách mô hình mà API Key hiện tại trả về.

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.0.

Định nghĩa kiểu TypeScript

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

model*string

ID mô hình Seedance 2.0 hoặc ID điểm truy cập suy luận (Endpoint) đã được cấu hình với mô hình này. Hỗ trợ doubao-seedance-2-0-260128 và doubao-seedance-2-0-fast-260128; phạm vi khả dụng thực tế tùy thuộc vào API Key hiện tại.

Độ dài1 <= length

content*array<>

Danh sách đầu vào. Chế độ tham chiếu hỗ trợ tối đa 9 ảnh, 3 video và 3 đoạn âm thanh. Mỗi video hoặc đoạn âm thanh dài 2–15 giây; tổng mỗi loại không quá 15 giây. Âm thanh phải đi kèm ít nhất một ảnh hoặc video. Không trộn chế độ khung đầu hoặc khung đầu/cuối với tham chiếu đa phương thức.

Số phần tử1 <= items

generate_audio?boolean

Có tạo âm thanh đồng bộ với hình ảnh hay không. Khi đặt thành true, mô hình có thể tạo giọng nói, hiệu ứng âm thanh và nhạc nền phù hợp dựa trên prompt và nội dung hình ảnh; khi đặt thành false, đầu ra là video không có âm thanh.

ratio?string

Tỷ lệ khung hình video. Seedance 2.0 và Seedance 2.0 fast mặc định sử dụng adaptive để tự chọn tỷ lệ phù hợp với đầu vào.

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?|unknown

Thời lượng video được tạo, tính bằng giây. Seedance 2.0 và Seedance 2.0 fast hỗ trợ số nguyên từ 4 đến 15, hoặc sử dụng -1 để mô hình quyết định thời lượng.

resolution?string

Độ phân giải video, mặc định 720p. Seedance 2.0 tiêu chuẩn hỗ trợ 480p/720p/1080p/4k; Seedance 2.0 fast chỉ hỗ trợ 480p/720p.

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

Giá trị được phép

"480p"
"720p"
"1080p"
"4k"

watermark?boolean

Có thêm watermark vào video được tạo hay không.

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 nhận callback POST khi trạng thái tác vụ thay đổi. Cấu trúc nội dung callback giống phản hồi của API truy vấn tác vụ; nếu không cấu hình, có thể truy vấn định kỳ trạng thái tác vụ.

Đị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. Tác vụ chưa hoàn tất sau khoảng thời gian này sẽ bị dừng và được đánh dấu là expired.

Đị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. Loại công cụ và tham số mở rộng tùy thuộc vào khả năng của mô hình và tài khoản hiện tại.

service_tier?string

Cấp dịch vụ được sử dụng cho tác vụ. Seedance 2.0 và Seedance 2.0 fast sử dụng dịch vụ suy luận trực tuyến default, không hỗ trợ suy luận ngoại tuyến flex.

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

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ỏ Giáng sinh đang bay"      }    ],    "generate_audio": true,    "ratio": "16:9",    "duration": 11,    "resolution": "1080p",    "watermark": false,    "execution_expires_after": 172800  }'

{
  "id": "cgt-20260330164007-wnc8k",
  "task_id": "cgt-20260330164007-wnc8k",
  "object": "video",
  "model": "MODEL_ID",
  "status": "queued",
  "progress": 0,
  "created_at": 1774860007
}

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.0 — 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`