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

Truy vấn tác vụ video Seedance 2.5 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ả. Phản hồi mặc định sử dụng cấu trúc bao tương thích của nền tảng gồm code, message và data; 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 data.data, show_usage=true đính kèm thông tin sử dụng do nền tảng tổng hợp trong data.usage. URL video có thể có thời hạn hiệu lực; hãy 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.

Khi truy vấn bản nháp Draft và video hoàn chỉnh, dùng draft và draft_task_id trong dữ liệu gốc để phân biệt tác vụ. Xem quy trình đầy đủ tại Hướng dẫn tạo video nháp Draft.

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.5. Mặc định, API trả về cấu trúc bao tương thích của nền tảng gồm code, message và data; dừng truy vấn định kỳ khi tác vụ chuyển sang succeeded, completed hoặc failed.

Truyền raw=true để đọc 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 data.data của cấu trúc bao tương thích; show_usage=true đính kèm thông tin sử dụng do nền tảng tổng hợp trong data.usage của tác vụ thành công.

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ụ Seedance 2.5.

Độ 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 đã được lưu.

show_raw?boolean

Truyền true để đính kèm dữ liệu tác vụ gốc từ upstream trong 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 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/task_xxxxx"

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_xxxxx",
    "status": "succeeded",
    "url": "https://example.com/generated-video.mov",
    "format": "mov",
    "metadata": null,
    "error": null
  }
}

Tham khảo cấu trúc tác vụ nguyên bản Seedance 2.5Xem 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.5 — 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

404

429application/json

500application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`