海螺hailuo视频模型文件URL查询下载API文档

接口说明

通过文件ID和任务ID查询视频文件信息及获取下载链接

概念说明

• file_id: 视频文件的唯一标识符
• task_id: 生成该视频的任务ID
• download_url: 视频文件的临时下载链接（通常有有效期）

接口地址

GET https://www.dmxapi.cn/v1/files/retrieve

请求参数

参数名	类型	必填	说明
file_id	string	是	要查询的视频文件ID
task_id	string	是	关联的任务ID

请求示例

import requests

# API配置
url = "https://www.dmxapi.cn/v1/files/retrieve?file_id=312214295695552&task_id=312210587099664"
api_key = "sk-*********************************************"  # 替换为你的 DMXAPI 令牌

payload = {}
headers = {"Authorization": f"Bearer {api_key}"}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

返回参数

{
  "file": {
    "file_id": "312214295695552",
    "bytes": 0,
    "created_at": 1757776993,
    "filename": "output_aigc.mp4",
    "purpose": "video_generation",
    "download_url": "https://xxxxxxxxxxxxxxxxxxx.mp4"   # 生成的视频URL，请尽快下载
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

字段说明

file对象

• file_id: 文件唯一标识
• bytes: 文件大小(字节)
• created_at: 文件创建时间戳
• filename: 文件名
• purpose: 文件用途
• download_url: 临时下载链接

base_resp对象

• status_code: 0表示成功，非0表示错误
• status_msg: 状态描述信息