Chuyển đến nội dung chính
GET
/
v1
/
videos
/
{id}
cURL
curl https://api.cometapi.com/v1/videos/<TASK_ID> \
  -H "Authorization: Bearer <COMETAPI_KEY>"
{ "id": "task_abc123", "model": "doubao-seedance-2-0-fast", "object": "video", "status": "IN_PROGRESS", "progress": 45, "created_at": 1776567610, "completed_at": null }
Sử dụng endpoint này để đọc trạng thái của một tác vụ được tạo qua Tạo một video Seedance. id trong path là giá trị được trả về từ lệnh gọi tạo, bất kể mô hình Seedance nào đã tạo ra tác vụ.

​
Máy trạng thái

Tác vụ sẽ đi qua một trong các trạng thái dưới đây. SUBMITTED và IN_PROGRESS là các trạng thái chưa kết thúc; SUCCESS, FAILED và ERROR là các trạng thái kết thúc và tác vụ sẽ không thay đổi nữa.
StatusMeaningTerminal
SUBMITTEDĐã được chấp nhận và đưa vào hàng đợi để render.không
IN_PROGRESSĐang render.không
SUCCESSĐã hoàn tất. video_url có trong phản hồi.có
FAILEDNhà cung cấp đã từ chối tác vụ.có
ERRORMột lỗi nội bộ đã ngăn việc hoàn tất.có

​
Nhịp độ thăm dò

Thăm dò mỗi 10 đến 20 giây. Hầu hết các 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à độ phân giải. 
import time
import requests

TASK_ID = "<TASK_ID>"
headers = {"Authorization": "Bearer <COMETAPI_KEY>"}
TERMINAL = {"SUCCESS", "FAILED", "ERROR"}

while True:
    response = requests.get(
        f"https://api.cometapi.com/v1/videos/{TASK_ID}",
        headers=headers,
        timeout=15,
    )
    response.raise_for_status()
    data = response.json()
    if data["status"] in TERMINAL:
        print(data.get("video_url"))
        break
    time.sleep(10)

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

  • status — xác đị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 giao diện người dùng.
  • video_url — URL tải xuống đã ký, chỉ có khi SUCCESS. Chữ ký có thời hạn; 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 được điền khi tác vụ đạt trạng thái kết thúc.
  • model — phản chiếu model ID của 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" có nghĩa là id không tồn tại. Hãy xác nhận rằng bạn đã lấy đúng id từ phản hồi POST /v1/videos thành công và đang dùng nguyên văn giá trị đó.
  • HTTP 401 có nghĩa là bearer token bị thiếu hoặc không hợp lệ. Hãy kiểm tra rằng header của request 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 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. SUBMITTED and IN_PROGRESS are non-terminal. SUCCESS, FAILED, and ERROR are terminal.

Tùy chọn có sẵn:
SUBMITTED,
IN_PROGRESS,
SUCCESS,
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 only when status is SUCCESS. 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

Task completion time as a Unix timestamp in seconds. null while the task is non-terminal.