文档

API 参考

查询托管文件

GET/v1/files/{file_id}

同账户同 Key 历史文件；允许耗尽但有效的 Key，撤销/过期仍拒绝。下载需 ready，引用中删除 409；retry 只重试保存原结果，非重新生成。普通 API 按保留天数，持久任务保护引用，expires_at=0 不定时过期。

鉴权与权限

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

Authorization: Bearer $GLOOP_API_KEY

鉴权方案： BearerAuth

请求

路径参数

  • file_idstring必填

    同 Key 的托管文件公开 ID。

响应与错误

HTTP 200

查询托管文件成功

application/json

类型
object
必填字段
idsource_kindsource_indexmodelstatusmime_typefile_namesize_bytescreated_atupdated_atexpires_at
  • idstring必填

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

  • source_kindstring必填

    文件来源类别；决定生命周期和引用保护规则。

  • source_indexinteger必填

    来源结果项索引。

  • modelstring必填

    当前 Key 目录中的公开模型 ID。

  • statusstring必填

    waiting/pending/archiving/ready/failed/deleting 等后台存储阶段；ready 后才可取得下载地址。

  • mime_typestring必填

    已核验文件 MIME 类型。

  • file_namestring必填

    公开下载文件名。

  • sha256string选填

    归档内容 SHA-256，若已确定则返回。

  • size_bytesinteger必填

    文件字节数。

  • error_codestring选填

    可用于分支处理的公开错误码。

  • created_atinteger必填

    Unix 秒创建时间。

  • updated_atinteger必填

    Unix 秒最后更新时间。

  • expires_atinteger必填

    Unix 秒；0 表示长期保留。普通 API 按部署天数策略；持久图像/视频引用保护结果，删除仍保留账务及幂等记录。

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 429

请求/队列限流。

application/json

类型
object
必填字段
error

HTTP 500

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

application/json

类型
object
必填字段
error

HTTP 503

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

application/json

类型
object
必填字段
error