Skip to main content
GET
cURL
Sử dụng endpoint này để đọc trạng thái của một tác vụ được tạo thông qua Tạo một video Seedance. id trong path là giá trị được trả về bởi lệnh gọi tạo, bất kể model Seedance nào đã tạo ra tác vụ. Phần thân phản hồi chính là đối tượng tác vụ video. Đọc status, progressvideo_url ở cấp cao nhất.

Máy trạng thái

API trả về các chuỗi trạng thái viết thường. queuedin_progress là không kết thúc; completed, failederror là kết thúc và tác vụ sẽ không thay đổi nữa.

Nhịp độ thăm dò

Thăm dò mỗi 10 đến 20 giây. Hầu hết tác vụ hoàn tất trong vòng 1 đến 3 phút tùy thuộc vào model, thời lượng và kích thước.

Các trường cần theo dõi

  • status — quyết định điều kiện dừng cho vòng lặp thăm dò của bạn.
  • progress — số nguyên từ 0 đến 100 mà bạn có thể hiển thị trong UI.
  • video_url — URL tải xuống đã ký, có trong các phản hồi completed. Tải xuống Seedance sử dụng trực tiếp URL này thay vì một route /v1/videos/{id}/content riêng. Chữ ký có giới hạn thời gian; hãy tải xuống hoặc lưu trữ lại tệp trước khi chữ ký hết hạn.
  • completed_at — dấu thời gian Unix tùy chọn do nền tảng trả về. Không dùng trường này để dừng thăm dò; hãy dùng status thay thế.
  • model — phản hồi lại model id Seedance đã được dùng khi tác vụ được tạo.

Các lỗi thường gặp

  • HTTP 400 với message: "task_not_exist" nghĩa là id không tồn tại. Hãy xác nhận rằng bạn đã lấy id từ một phản hồi POST /v1/videos thành công và đang dùng nguyên văn giá trị đó.
  • HTTP 401 nghĩa là bearer token bị thiếu hoặc không hợp lệ. Kiểm tra rằng header yêu cầu là Authorization: Bearer $COMETAPI_KEY.

Ủ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 POST /v1/videos.

Phản hồi

Current Seedance video task state.

id
string
bắt buộc

Task id.

object
string
bắt buộc

Object type, always video.

model
string
bắt buộc

Model id that generated the task.

status
enum<string>
bắt buộc

Task status. queued and in_progress are non-terminal. completed, failed, and error are terminal.

Tùy chọn có sẵn:
queued,
in_progress,
completed,
failed,
error
progress
integer
bắt buộc

Completion percentage.

Phạm vi bắt buộc: 0 <= x <= 100
created_at
integer
bắt buộc

Task creation time as a Unix timestamp in seconds.

video_url
string | null

Signed download URL for the finished video. Present on completed responses. Seedance downloads use this URL directly instead of a separate /v1/videos/{id}/content route. The signature is time-limited, so download or re-upload the file to your own storage soon after you receive it.

completed_at
integer | null

Optional Unix timestamp returned by the platform. Use status, not this field, to decide when polling can stop.