查询资产下载信息

从源码生成 GET /assets/{asset_id} 的鉴权、字段、响应、错误与安全调用参考。

公开测试API v1 · 1.3.0最后核实 2026-08-30

本页目录

操作

GET /assets/{asset_id}

operationId: get_asset_v1_assets__asset_id__get

读取所属资产并返回新的短期签名下载 URL。持久保存资产 ID，而不是过期链接。实际下载及存储跳转均不应携带 API 凭据，仍受归属和保留策略限制。

鉴权与副作用

使用可信环境中的 Bearer API Key。所需权限：animations:read

此操作不启动付费生成，其他状态变化见上文说明。

参数

参数	位置	类型	必填	约束 / 默认值	含义
`asset_id`	`path`	`string`	是	`format`: `uuid`	所属公共资源 UUID；任务、资产、文件 ID 不能互换。

响应

HTTP	正文	含义
`200`	AssetResponse	成功的公开响应，示例数值仅用于说明。
`400`	APIErrorEnvelope	输入错误，修正请求后再尝试。
`401`	APIErrorEnvelope	API Key 缺失、到期或被撤销。
`403`	APIErrorEnvelope	账户资格、账户状态或 Key 权限不允许此操作。
`404`	APIErrorEnvelope	资源不可用、不属于当前用户，或签名无效/过期。
`429`	APIErrorEnvelope	触发账户级速率或队列限制，遵循 Retry-After 等待。
`500`	APIErrorEnvelope	内部错误，保留任务 ID 和幂等键，仅标记可重试时重试。
`503`	APIErrorEnvelope	服务或供应商不可用，仅 error.retryable 为 true 时重试。

响应头

HTTP	响应头	类型	含义
`429`	`Retry-After`	`integer`	建议等待秒数，遵循服务值并设置总体截止时间。
`503`	`Retry-After`	`integer`	建议等待秒数，遵循服务值并设置总体截止时间。

响应示例

json

{
  "byte_size": 1024,
  "created_at": "2026-08-30T00:00:00Z",
  "download_expires_at": "2026-08-30T01:00:00Z",
  "download_url": "https://downloads.example.invalid/illustrative-asset",
  "format": "clip_video",
  "id": "00000000-0000-4000-8000-000000000003",
  "mime_type": "video/mp4",
  "object": "asset"
}

这篇文档有帮助吗？

允许文档使用分析

不收集搜索词、代码或自由文本。此开关只控制文档交互事件；站点通用分析仍遵循隐私政策。隐私政策

需要帮助？联系支持

搜索文档

查询资产下载信息

操作

鉴权与副作用

参数

响应

响应头

响应示例

相关教程

这篇文档有帮助吗？