下载图片结果

使用任务结果中的短期签名 URL 下载图片。

GET/api/v1/assets/{asset_id}/content

浏览常用接口

接口说明

签名 URL 已绑定账户、任务、资源、表示方式与资源删除时间。请原样使用完整 URL，不要自行重建签名，也不要添加 Bearer Key。

认证：签名 URL

请求

路径参数

名称	类型	说明
`asset_id`必填	string	任务结果返回的资源 ID。

查询参数

名称	类型	说明
`expires`必填	string	签名 URL 自带的固定到期值。
`representation`必填	url	固定为 url。
`signature`必填	string	服务端签发的短期签名。

响应

成功响应是图片二进制；错误仍返回统一 JSON 错误信封。

HTTP	含义
`200`	请求成功
`404`	资源不存在，或签名无效
`410`	任务结果或签名资源已过期
`500`	服务内部错误

成功响应类型

image/png | image/jpeg | image/webp

重要边界

图片在服务端保留 3 小时并自动清除；签名 URL 的到期时间不会超过图片删除时间。
此接口返回二进制，不在只处理 JSON 的在线调试器中执行。

查看机器可读 OpenAPI

代码与在线调试

GET · /api/v1/assets/{asset_id}/content

curl -X GET "$OGA_BASE_URL/api/v1/assets/asset_01JEXAMPLE/content?expires=<EXPIRES>&representation=<REPRESENTATION>&signature=<SIGNATURE>" \
  -H "X-Request-Id: <UUID_V4>" \
  -H "Accept-Language: zh-CN"

请求只发送到当前网站同源的固定接口。API Key 只保留在本页密码框内；页面不会把它写入 URL、持久化数据或复制示例。

此接口返回图片二进制。为避免把私有资源加载进文档页，只提供可复制的命令，不在 JSON 调试器中执行。

响应