Truy vấn video

Lưu ID do API tạo trả về và truy vấn bằng API Key cùng trang. Dừng thăm dò không hủy việc tạo.

GET/v1/video/generations/{task_id}

Dùng ID từ API tạo nền tảng để truy vấn tác vụ của người dùng. Dừng thăm dò phía máy khách không hủy việc tạo.

Xác thực

bearerAuth

Xác thựcBearer <token>

Dùng API Key nền tảng: Authorization: Bearer your-api-key.

Vị trí truyền: header

Tham số đường dẫn

task_id*string

ID hệ thống do API tạo trả về. ID mới là chuỗi; không đổi sang số để tránh mất độ chính xác.

Độ dài1 <= length

Nội dung phản hồi

`application/json`

curl -X GET "https://api.agtcloud.cn/v1/video/generations/TASK_ID" \
  -H "Authorization: Bearer your-api-key"

{
  "code": "success",
  "message": "",
  "data": {
    "error": null,
    "format": "mp4",
    "metadata": null,
    "status": "processing",
    "task_id": "123456789012345678",
    "url": ""
  }
}

Đọc kết quả truy vấn

Phản hồi nền tảng có cấu trúc code/message/data, data là một đối tượng tác vụ. code: "success" nghĩa là truy vấn thành công; vẫn phải xem data.status để biết đã tạo xong chưa.

Tình huống	Ý nghĩa và xử lý
HTTP 200, `data.status: "processing"`	Đang xử lý; `data.url` có thể là chuỗi rỗng. Truy vấn lại sau
HTTP 200, `data.status: "succeeded"`	Tạo thành công; đọc URL từ `data.url` và lưu ngay
HTTP 400, `code: "task_not_exist"`	Không tìm thấy tác vụ; kiểm tra ID, API Key và trang
HTTP 401, `Invalid token`	Kiểm tra Bearer và trang của API Key; Key thiếu hoặc không hợp lệ có thể trả cùng lỗi

data.error và data.metadata có thể là null. Cấu trúc nền tảng khác data[] của truy vấn gốc. Xem trường gốc và giá niêm yết tại API truy vấn gốc.

HTTP 400/401 là lỗi yêu cầu truy vấn, không phải tạo video thất bại. Phản hồi lỗi có thể không có đối tượng tác vụ bình thường. Xử lý lỗi trước khi đọc URL hoặc tiếp tục thăm dò.

Xác thực

Tham số đường dẫn

Nội dung phản hồi

200application/json

400application/json

401application/json

Đọc kết quả truy vấn

`application/json`

`application/json`

`application/json`