Truy vấn video

Dùng ID tác vụ do API tạo tác vụ trả về để truy vấn trạng thái, kết quả và thông tin sử dụng; sau khi thành công, có thể lấy URL video từ task.content.url.

GET/v2/query/video_generation/{task_id}

Dùng Task ID do API tạo tác vụ trả về để truy vấn. Bên gọi chỉ có thể truy vấn tác vụ do mình tạo.

Nên truy vấn mỗi 3 đến 5 giây cho đến khi trạng thái chuyển sang succeeded, failed hoặc cancelled. Tiếp tục polling khi trạng thái là queued hoặc running.

Nếu upstream MiniMax trả về lỗi JSON hợp lệ, API giữ nguyên mã trạng thái HTTP và nội dung JSON của upstream.

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

Task ID được trả về khi tạo video MiniMax-H3.

Độ dài1 <= length

Nội dung phản hồi

`application/json`

curl -X GET "https://example.com/v2/query/video_generation/426014652088710"

{
  "task": {
    "id": "426014652088710",
    "model": "MODEL_ID",
    "status": "succeeded",
    "content": {
      "url": "https://example.com/result.mp4"
    },
    "resolution": "2K",
    "duration": 5,
    "ratio": "16:9",
    "task_type": "generation",
    "created_at": 1789625341,
    "updated_at": 1789625437,
    "usage": {
      "input_image_count": 2,
      "input_seconds": 5,
      "input_audio_seconds": 6,
      "output_seconds": 5,
      "total_seconds": 10,
      "prompt_tokens": 480,
      "completion_tokens": 130196,
      "total_tokens": 130676
    }
  }
}

Xác thực

Tham số đường dẫn

Nội dung phản hồi

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`