Chuyển đến nội dung chính
GET
/
volc
/
v3
/
contents
/
generations
/
tasks
/
{id}
Query a ByteDance video task
curl --request GET \
  --url https://api.cometapi.com/volc/v3/contents/generations/tasks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "021773297205999example",
  "model": "doubao-seedance-1-5-pro-251215",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/generated.mp4"
  },
  "created_at": 1773297205,
  "updated_at": 1773297260,
  "resolution": "720p",
  "duration": 5,
  "ratio": "16:9",
  "framespersecond": 24
}
Sử dụng endpoint này sau khi bạn tạo một tác vụ ByteDance Jimeng. Endpoint này không bắt đầu render. Nó chỉ báo cáo trạng thái hiện tại của tác vụ và, khi job hoàn tất, URL video được tạo cùng metadata đầu ra.

Theo dõi các trường này

  • status cho trạng thái hiện tại từ provider
  • content.video_url khi quá trình render hoàn tất
  • resolution, duration, ratio, và framespersecond nếu ứng dụng của bạn cần metadata đầu ra

Vòng lặp polling

1

Tạo tác vụ trước

Bắt đầu với ByteDance Video Generation.
2

Polling theo task id

Tiếp tục gọi endpoint này cho đến khi trạng thái đạt tới một trạng thái kết thúc.
3

Lưu kết quả

Khi content.video_url xuất hiện, hãy sao chép kết quả vào hệ thống lưu trữ của riêng bạn nếu bạn cần lưu giữ lâu dài.

URL kết quả

Quy trình ByteDance vẫn là tạo trước, sau đó truy vấn bằng task id. CometAPI giữ nguyên cấu trúc đó và chuẩn hóa xác thực. Hãy xem URL video được trả về là URL phân phối, không phải nơi lưu trữ vĩnh viễn.

Ủy quyền

Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Tham số đường dẫn

id
string
bắt buộc

Task id returned by the create endpoint.

Phản hồi

200 - application/json

Current task state.

id
string
bắt buộc
model
string
bắt buộc
status
string
bắt buộc

Provider task status.

created_at
integer
bắt buộc
updated_at
integer
bắt buộc
content
object
usage
object
seed
integer
resolution
string
duration
integer
ratio
string
framespersecond
integer