下载资产
GET /v1/tasks/{id}/assets/{index}
使用任务 API Key 直接下载指定位置(从 0 开始)的资产,无需依赖任务响应中的签名 URL。
bash
curl https://api.llmapi.site/v1/tasks/8b17fd33b0e947a08cb417e81e9ea9da/assets/0 \
-H 'Authorization: Bearer YOUR_TASK_API_KEY' \
--output result.png图片和已转存的视频资产使用同一个下载接口;后续音频和 3D 资产也沿用相同结构。先从任务查询响应读取 assets[index] 的 kind、content_type 和 size_bytes,再选择文件名和处理方式。视频 Adapter 与图片 Adapter 使用相同的转存资产下载协议。
响应
该接口会直接返回二进制资产,或重定向到签名资产 URL。
| 状态码 | 说明 |
|---|---|
200 OK | 返回二进制资产,Content-Type 与资产类型一致,例如 image/png、video/mp4 或 model/gltf-binary。 |
302 Found | 重定向到签名资产 URL,HTTP 客户端应跟随重定向。 |
错误码
| 状态码 | 原因 |
|---|---|
401 | API Key 缺失或无效。 |
403 | API Key 未启用任务 API。 |
404 | 任务或资产索引不存在。 |
503 | 资产存储不可用。 |
资产 metadata 不编码在下载响应头中,只包含服务端白名单允许的稀疏媒体字段。当前视频转存链路不保证宽高、时长、帧率或音频 metadata;content_type 和 size_bytes 才是稳定的下载事实。