下载：视频地址

概览

• 接口：下载视频地址（GET /task/minimax/v1/files/retrieve）
• 说明：根据生成任务查询结果返回的 file_id，调用此接口获取视频下载地址与文件信息。

认证

• 使用 Bearer Token（在请求头 Authorization: Bearer <token> 中传入）。

请求参数

• Query 参数：

  • file_id (string, 必填)
    • 通过查询接口获得的 file_id，用于检索文件信息与下载地址。

返回说明

• 返回 Content-Type：application/json

• 重要字段：

  • file (object)：文件信息

    • file_id (integer)：文件 ID。
    • bytes (integer)：文件大小（字节）。
    • created_at (integer)：创建时间戳。
    • filename (string)：文件名（例如 output.mp4）。
    • purpose (string)：用途（如 video_generation）。
    • download_url (string)：可直接下载或播放的文件地址。

  • base_resp (object)：基础返回信息，包含 status_code 与 status_msg。

成功响应示例

{
  "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"
  }
}

说明

• 若返回 download_url，可直接下载或播放视频；若未直接返回地址，需结合平台的下载接口进行处理。
• file_id 来源于任务查询接口的返回，请先确保任务已完成并能获取到有效 file_id。