Tạo video ByteDance

Sử dụng endpoint bytedance-video để tạo và quản lý các tác vụ tạo video qua POST /volc/v3/contents/generations/tasks, với các tham số linh hoạt.

POST /volc/v3/contents/generations/tasks

cURL

Text to video

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"
    }
  ]
}
'

200

{
  "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.

Show child attributes

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.