文档

API 参考

查询参考图

GET/v1/image-assets/{asset_id}

同账户同 Key；失效 410，未完成任务引用时删除 409。

鉴权与权限

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

Authorization: Bearer $GLOOP_API_KEY

鉴权方案： BearerAuth

请求

路径参数

  • asset_idstring必填

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

响应与错误

HTTP 200

查询参考图成功

application/json

类型
object
必填字段
idmime_typesize_byteswidthheightexpires_at
  • file_idstring选填

    同账户同 Key 的托管文件公开 ID。

  • idstring必填

    该对象的公开标识符；用于对应详情路径。

  • mime_typestring必填

    已核验文件 MIME 类型。

  • size_bytesinteger必填

    文件字节数。

  • widthinteger必填

    图片像素宽度。

  • heightinteger必填

    图片像素高度。

  • expires_atinteger必填

    Unix 秒；0 表示无固定过期时间。上传关联托管文件；读取必须使用同账户同 Key。

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