Download: Video Address

Overview

• API: Download video address (GET /task/minimax/v1/files/retrieve)
• Description: Retrieve the video download address and file information using the file_id returned by the task query response.

Authentication

• Use Bearer Token in the request header: Authorization: Bearer <token>.

Request Parameters

• Query parameter:
  • file_id (string, required)
    • The file_id obtained from the task query response, used to retrieve file metadata and the download URL.

Response Details

• Response Content-Type: application/json

• Important fields:

  • file (object): file information
    • file_id (integer): file ID.
    • bytes (integer): file size in bytes.
    • created_at (integer): creation timestamp.
    • filename (string): file name, e.g. output.mp4.
    • purpose (string): purpose, e.g. video_generation.
    • download_url (string): URL for direct download or playback.
  • base_resp (object): basic response metadata, includes status_code and status_msg.

Success Response Example

{
  "file": {
    "file_id": 313992866418884,
    "bytes": 0,
    "created_at": 1758211235,
    "filename": "output.mp4",
    "purpose": "video_generation",
    "download_url": "https://video-product.cdn.minimax.io/inference_output/video/2025-09-19/5c06f899-c689-4dfb-93f6-e4468a2743fc/output.mp4"
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

Notes

• If a download_url is returned, you can download or play the video directly. If no direct URL is provided, use the platform's download API as required.
• The file_id comes from the task query response. Make sure the task is complete and the file_id is valid before calling this endpoint.