参考视频上传（Reference Video Upload）


POST https://ai.amaxsmp.com/v1/video/reference/upload

上传本地视频，获取可供视频模型读取的 URL。上传不会自动开始生成；需要将响应中的 data.url 传给视频生成接口的 video 参数。

文件要求

项目	要求
文件格式	MP4（`.mp4`）、MOV（`.mov`）
文件类型	`video/mp4`、`video/quicktime`，需与扩展名对应
文件大小	大于 0，最大 100MB（100 × 1024 × 1024 字节）
文件数量	每次上传一个文件
存储空间	需要足够的数字资产可用空间

上传成功不代表所有模型都能使用该视频。参考视频的时长、内容和数量等限制，仍由所选生成模型决定。

请求示例

cURL


curl https://ai.amaxsmp.com/v1/video/reference/upload \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -F "file=@/path/to/reference.mp4;type=video/mp4"

使用 multipart/form-data 上传，由客户端自动生成包含文件分隔符的 Content-Type，不要手动设置为 application/json。

Python（requests）

安装依赖：pip install requests。


import requests
 
with open("reference.mp4", "rb") as video:
    response = requests.post(
        "https://ai.amaxsmp.com/v1/video/reference/upload",
        headers={"Authorization": "Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
        files={"file": ("reference.mp4", video, "video/mp4")},
        timeout=120,
    )
response.raise_for_status()
payload = response.json()
if not payload.get("success"):
    raise RuntimeError(payload)
print(payload["data"]["url"])

请求参数

参数	类型	必填	说明
`file`	file	是	参考视频文件，支持 MP4 或 MOV，最大 100MB

响应示例


{
  "success": true,
  "data": {
    "asset_id": 123,
    "url": "https://example.com/reference.mp4",
    "file_name": "reference.mp4",
    "file_size": 1048576,
    "mime_type": "video/mp4"
  }
}

字段	说明
`success`	上传是否成功
`data.asset_id`	数字资产 ID，不是视频生成任务 ID
`data.url`	素材地址，作为生成接口的 `video` 参数
`data.file_name`	文件名
`data.file_size`	文件大小，单位为字节
`data.mime_type`	文件类型

常见错误

HTTP 状态码	错误码	说明
401	以响应为准	缺少或无效的 API Key
400	`INVALID_REFERENCE_VIDEO`	文件扩展名或类型不符合要求
400	`EMPTY_REFERENCE_VIDEO`	文件为空
413	`REFERENCE_VIDEO_TOO_LARGE`	文件超过 100MB
以响应为准	`USER_ASSET_CAPACITY_FULL`	数字资产空间不足
以响应为准	`USER_ASSET_ARCHIVE_FAILED`	上传归档失败

文件校验错误返回 success: false、code 和 message；缺少鉴权信息等错误也可能使用 detail 字段。