Seedance 2.0 — Truy vấn video (định dạng nền tảng)

Truy vấn tác vụ video Seedance 2.0 qua API Video Generations của nền tảng.

Sử dụng ID tác vụ để truy vấn trạng thái và kết quả. Mặc định trả về đối tượng tác vụ nền tảng; raw=true trả về trực tiếp cấu trúc tác vụ nguyên bản của Volcengine Ark, show_raw=true đính kèm cùng cấu trúc nguyên bản trong cấu trúc bao của nền tảng, show_usage=true trả về thông tin sử dụng do nền tảng tổng hợp. URL video và khung hình cuối có thể có thời hạn hiệu lực; hãy tải xuống hoặc lưu sang nơi khác kịp thời.

Nếu cần lấy trực tiếp cấu trúc tác vụ của Volcengine Ark, hãy xem API truy vấn theo định dạng nguyên bản.

Dữ liệu tác vụ gốc hỗ trợ độ phân giải 4k của Seedance 2.0 tiêu chuẩn và priority của tác vụ; Fast chỉ hỗ trợ 480p/720p.

GET/v1/video/generations/{task_id}

Sử dụng ID tác vụ do API tạo tác vụ trả về để truy vấn tác vụ video Seedance 2.0. Dừng truy vấn định kỳ khi tác vụ chuyển sang completed hoặc failed.

Nên truy vấn mỗi 30 đến 60 giây. URL video hoàn tất có thể có thời hạn hiệu lực; hãy tải xuống và lưu sang nơi khác kịp thời.

Xác thực

bearerAuth

Xác thựcBearer <token>

Sử dụng Bearer your-api-key trong Header Authorization.

Vị trí truyền: header

Tham số đường dẫn

task_id*string

ID tác vụ được trả về khi tạo tác vụ video.

Độ dài1 <= length

Tham số truy vấn

raw?boolean

Truyền true để trả về trực tiếp dữ liệu tác vụ gốc từ upstream, giúp chẩn đoán vấn đề.

show_raw?boolean

Truyền true để đính kèm dữ liệu tác vụ gốc từ upstream trong trường data.data của phản hồi được bao theo định dạng tương thích.

show_usage?boolean

Truyền true khi tác vụ thành công để đính kèm thông tin sử dụng trong trường data.usage của phản hồi được bao theo định dạng tương thích.

Nội dung phản hồi

`application/json`

curl -X GET "https://example.com/v1/video/generations/cgt-20260330164007-wnc8k"

{
  "id": "cgt-20260330164007-wnc8k",
  "task_id": "cgt-20260330164007-wnc8k",
  "object": "video",
  "model": "MODEL_ID",
  "status": "completed",
  "progress": 100,
  "created_at": 1774860007,
  "completed_at": 1774860088,
  "metadata": {
    "url": "https://example.com/generated-video.mp4"
  }
}

Tham khảo cấu trúc tác vụ nguyên bản Seedance 2.0Xem cấu trúc truy vấn tác vụ của Volcengine Ark được sử dụng với raw và show_raw.

Seedance 2.0 — Truy vấn video (định dạng nền tảng)

Xác thực

Tham số đường dẫn

Tham số truy vấn

Nội dung phản hồi

200application/json

400application/json

401application/json

402application/json

429application/json

500application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`