Chuyển đến nội dung chính
POST
/
volc
/
v3
/
contents
/
generations
/
tasks
curl --request POST \ --url https://api.cometapi.com/volc/v3/contents/generations/tasks \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "model": "doubao-seedance-1-5-pro-251215", "content": [ { "type": "text", "text": "A paper boat drifts on a quiet lake at sunrise. --duration 5 --ratio 16:9" } ] } '
{
  "id": "021773297205999example"
}
Sử dụng endpoint này để khởi tạo một tác vụ video ByteDance Seedance từ văn bản, hoặc từ văn bản kèm hình ảnh tham chiếu. Yêu cầu sẽ trả về task id ngay lập tức và quá trình render tiếp tục diễn ra bất đồng bộ.

​
Chọn đường dẫn model hiện tại

  • Sử dụng trang Models để xem tính khả dụng hiện tại của model và các mã định danh.
  • Sử dụng doubao-seedance-1-5-pro-251215 làm ví dụ production hiện tại cho route này.
  • Cùng một model hiện tại có thể xử lý cả yêu cầu chỉ-văn-bản và yêu cầu có hướng dẫn bằng hình ảnh thông qua mảng content hợp nhất.

​
Luồng tác vụ

1

Xây dựng mảng content

Đặt chỉ dẫn văn bản chính trước, sau đó chỉ thêm các mục hình ảnh khi bạn cần hướng dẫn khung hình đầu tiên hoặc khung hình cuối cùng.
2

Gửi tác vụ

Lưu task id được trả về. Nếu bạn muốn gửi kết quả qua push, hãy đặt callback_url khi tạo tác vụ.
3

Thăm dò cho đến khi có đầu ra

Gọi ByteDance Video Query cho đến khi tác vụ hoàn tất và có content.video_url.

​
Hành vi wrapper đã biết

Volcengine và Seedance mô tả họ endpoint này như một quy trình bất đồng bộ tạo-trước-rồi-truy-vấn. CometAPI giữ nguyên mô hình tác vụ đó nhưng cung cấp cho bạn một base URL và một API key.
Trong quá trình xác thực trực tiếp vào ngày 2026-03-12, route này có thể truy cập được nhưng vẫn trả về lỗi phân tích cú pháp JSON phía server đối với một mẫu JSON tiêu chuẩn. Hãy xem các ví dụ OpenAPI ở đây là tham chiếu wrapper thực tế, và xác thực payload của bạn sớm trong quá trình phát triển.

Ủy quyền

​
Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Nội dung

application/json
​
model
string
bắt buộc

ByteDance Seedance video model id. Choose a current model from the Models page. A current production example is doubao-seedance-1-5-pro-251215, which supports both text-only and image-guided requests through the same content array.

Ví dụ:

"doubao-seedance-1-5-pro-251215"

​
content
object[]
bắt buộc

Ordered input items for the task. Put the main text instruction first. Add image items when you need first-frame or last-frame guidance.

​
callback_url
string

Optional webhook URL for task status notifications.

Phản hồi

200 - application/json

Task accepted.

​
id
string
bắt buộc

Task id for later polling.