#媒体与图像 URL

Reelway 不接受把文件内联在 API 请求或 WebSocket 帧里。输入(参考图、首尾帧、参考音频)通过预签名上传 URL 直传对象存储;产物通过预签名下载 URL 获取。四个端点分为 image 与 media 两组槽位,语义相同,只在内容类型白名单上不同。

需要可复用的上传(多次项目引用同一文件、去重、配额管理)请使用资产库 /v1/assets,它在同一存储之上提供 prepare → PUT → finalize → bind 状态机。

#GET /v1/image/uploadUrl

#查询参数

#响应

{
  "status": "success",
  "data": {
    "uploadUrl": "https://…/presigned-put",
    "uploadHeaders": { "Content-Type": "image/png" }
  }
}

随后以 HTTP PUT 把文件体直传到 uploadUrl,并原样携带 uploadHeaders 中的每一个头:

curl --fail-with-body -X PUT "$UPLOAD_URL" \
  -H "Content-Type: image/png" \
  --data-binary @start-frame.png

#GET /v1/image/downloadUrl

#查询参数

#响应

{ "status": "success", "data": { "downloadUrl": "https://…/presigned-get" } }

对象不存在返回 404。complete 槽位按登记的产物解析对象键,因此只能在 jobResult 之后调用。

#GET /v1/media/uploadUrl 与 GET /v1/media/downloadUrl

参数与响应与 image 组完全一致。视频产物(MiniMax H3)与音频产物(CosyVoice 3)走本组。

#URL 有效期与安全

• jobResult 帧里的 resultUrl 与本页签发的 downloadUrl 均为48 小时有效的签名 URL;过期后重新调用 downloadUrl 即可再次签发。
• 签名 URL 可被任何持有者访问:不要写进日志或分享到公共渠道;需要公开分发请转存到自有存储。
• 上传 URL 仅接受一次 PUT 且绑定 contentType;类型不符会被存储侧拒绝。

#错误