Skip to content

下载资产

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]kindcontent_typesize_bytes,再选择文件名和处理方式。视频 Adapter 与图片 Adapter 使用相同的转存资产下载协议。

响应

该接口会直接返回二进制资产,或重定向到签名资产 URL。

状态码说明
200 OK返回二进制资产,Content-Type 与资产类型一致,例如 image/pngvideo/mp4model/gltf-binary
302 Found重定向到签名资产 URL,HTTP 客户端应跟随重定向。

错误码

状态码原因
401API Key 缺失或无效。
403API Key 未启用任务 API。
404任务或资产索引不存在。
503资产存储不可用。

资产 metadata 不编码在下载响应头中,只包含服务端白名单允许的稀疏媒体字段。当前视频转存链路不保证宽高、时长、帧率或音频 metadata;content_typesize_bytes 才是稳定的下载事实。