视频生成成功,下载链接过期了怎么办?
先用原任务号查结果,分清可续取的临时链接与已清理的文件;用临时文件和 FFmpeg 检查视频可解码后再入库。

视频任务已经成功、下载却返回 403 或 404 时,先查原任务,别重新生成。可能是地址过期、下载方式不对,也可能服务已经清理了原文件;这三种情况不是同一个错误。应用应当分别记录「服务已生成」和「文件已保存」。
先确认还能不能取到原件
MiniMax 官方 V2 的查询文档明确说,task.content.url 是临时下载链接,过期后可以重新查询获取新链接,但任务本身只有最近七天可查。七天是任务查询窗口,不是 URL 的有效期。Replicate 的保留规则写的是另一件事:通过 API 创建的预测,其输出文件等数据默认一小时后清理。如果原文件已经被清理,重查不等于一定能拿回视频。
保留任务号,用原来的服务和接口版本查询。如果重查成功仍拿不到文件,先按该服务文档区分权限、过期和文件清理。只有确认找不到可用副本,并愿意接受新任务的成本和生成差异,才把重新生成当成一个新决定。提交结果未知的情况另见视频任务的查询、等待与取消。
有的结果用链接下载,有的要带 Key
以本站的两套接口为例:Nbility MiniMax H3的成功响应给出完整 url,原样下载,不附 API Key。Seedance 原生查询的 content.video_url 是本站相对路径,应拼接固定的 API 根地址,并按文档带本站 Key 请求。不能凭字段名带 url 就把携带 Key 的请求发给任意域名,也不要把 Key 写进播放器地址。签名媒体链接本身也可能让持有者读取文件,不要贴到公开日志。
下载成功后先解码,再替换成片
下面的命令只用于已核对来源的完整 HTTPS MP4 链接,不适用于需要鉴权的相对路径。它用 curl、ffmpeg 和 Bash,把下载与校验放在同一目录的临时文件里;校验通过才用新文件替换 video.mp4。为避免并发争用,每个任务用独立工作目录。不要同时用同一个文件名保存多个任务。
set -euo pipefail
umask 077
: "${RESULT_URL:?Set RESULT_URL to the trusted HTTPS media URL}"
tmp_file=$(mktemp './video.XXXXXX')
trap 'rm -f -- "$tmp_file"' EXIT
curl --fail --silent --show-error --location \
--proto '=https' --proto-redir '=https' --max-time 120 \
--output "$tmp_file" --url "$RESULT_URL"
ffmpeg -v error -nostdin -xerror -abort_on empty_output \
-protocol_whitelist file -f mov -i "$tmp_file" \
-map 0:v:0 -map '0:a?' -f null -
mv -f -- "$tmp_file" ./video.mp4
-f mov 在输入侧选用 MOV/MP4 解复用器,适合这个 MP4 示例。脚本要求有视频流,顺带检查存在的音轨;如果交付要求必须有音频,还要单独把有音轨列为验收条件。HTTP 200 和文件非空都不代表媒体完整。即使解码通过,也要对照交付预期检查画幅和时长:只有几秒且能播放的文件,仍可能不是你要的成片。长片完整解码有成本,后台处理时另设大小和运行时间上限。
确认副本入库以后再发「可下载」消息;如果消息来自异步事件,另做视频回调去重。本文于 2026 年 11 月 20 日核对服务规则与 FFmpeg 命令文档;本地用合成 MP4 和错误输入检验文件处理,未访问真实生成结果或测量链接有效期。


