文档

API 参考

读取参考图内容

GET/v1/image-assets/{asset_id}/content

需 Bearer Key。已保存的参考图返回 307，重定向到短时签名 URL；已失效的历史参考图返回 410 asset_expired。

鉴权与权限

使用当前 GloopAPI Key。模型、功能与权限以当前 Key 的目录及接口说明为准。

Authorization: Bearer $GLOOP_API_KEY

鉴权方案： BearerAuth

请求

路径参数

  • asset_idstring必填

    同 Key 上传的 ia_ 图片资产 ID。

响应与错误

HTTP 307

重定向至短时签名 URL，不含 JSON。

无响应正文。

响应头 Location
{"schema":{"type":"string"}}

HTTP 400

请求字段或参数无效。

application/json

类型
object
必填字段
error

HTTP 401

Key 缺失、无效、过期或已撤销。

application/json

类型
object
必填字段
error

HTTP 403

IP、账户、模型或工具权限不足。

application/json

类型
object
必填字段
error

HTTP 404

对象/能力不可用，或功能开关关闭。

application/json

类型
object
必填字段
error

HTTP 409

幂等/报价冲突、对象未准备或仍被引用。

application/json

类型
object
必填字段
error

HTTP 410

参考图已过期或已删除（asset_expired）。

application/json

类型
object
必填字段
error

HTTP 429

请求/队列限流。

application/json

类型
object
必填字段
error

HTTP 500

鉴权或数据存储内部失败。

application/json

类型
object
必填字段
error

HTTP 503

服务、定价或存储不可用。

application/json

类型
object
必填字段
error