Truy xuất một video Seedance
Thăm dò một tác vụ video Seedance theo id trên CometAPI bằng GET /v1/videos/. Hoạt động với các tác vụ Seedance 1.0 Pro, 1.5 Pro và 2.0. Trả về trạng thái hiện tại, tiến độ và video_url đã ký sau khi tác vụ đạt completed.
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, progress và video_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.queued và in_progress là không kết thúc; completed, failed và error 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ồicompleted. Tải xuống Seedance sử dụng trực tiếp URL này thay vì một route/v1/videos/{id}/contentriê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ùngstatusthay 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
400vớimessage: "task_not_exist"nghĩa làidkhông tồn tại. Hãy xác nhận rằng bạn đã lấyidtừ một phản hồi POST/v1/videosthành công và đang dùng nguyên văn giá trị đó. - HTTP
401nghĩ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
Bearer token authentication. Use your CometAPI key.
Tham số đường dẫn
Task id returned by POST /v1/videos.
Phản hồi
Current Seedance video task state.
Task id.
Object type, always video.
Model id that generated the task.
Task status. queued and in_progress are non-terminal. completed, failed, and error are terminal.
queued, in_progress, completed, failed, error Completion percentage.
0 <= x <= 100Task creation time as a Unix timestamp in seconds.
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.
Optional Unix timestamp returned by the platform. Use status, not this field, to decide when polling can stop.