网络、下载与常见报错

成片 video_url 过期了怎么办？

content.video_url 是约 2 小时有效的临时签名链接。过期后重新调用查询接口 GET /api/v3/contents/generations/tasks/{id} 会得到新的下载链接。但强烈建议生成后尽快转存到自己的对象存储，不要长期依赖这个临时链接。

下载视频时要带 Authorization 头吗？

不要。video_url 本身是带签名的直链，下载时携带 Authorization 头反而可能导致失败。用干净的 GET 请求下载即可。

Python requests 报 JSON 解析错误 / 响应被截断？

在请求头加 Accept-Encoding: identity。个别网络环境下网关的 gzip 协商会导致 requests 解码异常、响应被截断。加这个头强制不压缩即可解决。

headers = {
    "Authorization": "Bearer sk-你的APIKey",
    "Accept-Encoding": "identity",  # 避免 gzip 解码异常
}

请求超时或偶发 5xx？

视频生成耗时较长，请给创建 / 查询请求设置合理的超时，并对 5xx 指数退避重试（2s → 4s → 8s）。查询用轮询而非长连接等待。持续性的服务异常可关注服务状态。

域名 / 路径应该怎么填？

Base URL 是 https://api.looprouter.com，视频接口路径 /api/v3/contents/generations/tasks，素材库 /api/v3/assets?Action=...&Version=2024-01-01。/api 前缀不能省略。详见 API Key 与鉴权。

下载慢 / 大文件怎么处理？

用流式下载（stream=True / 分块写入）避免一次性载入内存，尤其是 1080p / 4k 的长视频。示例见素材引用实战里的下载代码。

现象	原因	处理
视频 404 下载失败	`video_url` 已过期（约 2 小时）	重新查询任务获取新链接，尽快转存
Python JSON 解析异常 / 截断	网关 gzip 协商问题	请求头加 `Accept-Encoding: identity`
下载 403	带了 `Authorization` 头	下载直链时去掉鉴权头
404 找不到接口	漏了 `/api` 前缀	路径写全 `/api/v3/...`
400 `asset not found or not active`	素材还在 `Processing` 或 ID 写错	先 `GetAsset` 确认 `Active`

素材引用实战

下载与报错速查

API Key 与鉴权

Base URL 与请求头

并发与限流

重试策略

模型与调用

令牌与计费

素材与安全

网络、下载与常见报错

常见报错速查

相关文档

素材引用实战

API Key 与鉴权

并发与限流

​常见报错速查

​相关文档

素材引用实战

API Key 与鉴权

并发与限流

常见报错速查

相关文档