文档

API 参考

查询托管文件

GET/v1/files

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

鉴权与权限

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

Authorization: Bearer $GLOOP_API_KEY

鉴权方案： BearerAuth

请求

查询参数

  • afterinteger选填

    使用原响应 next_cursor，每页由服务固定 50 项。

    默认值
    0
    最小值
    0

响应与错误

HTTP 200

查询托管文件成功

application/json

类型
object
必填字段
datanext_cursor
  • dataarray必填
    data 子字段（1）
    • []object选填
      [] 子字段（13）
      • 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 按部署天数策略；持久图像/视频引用保护结果，删除仍保留账务及幂等记录。

  • next_cursorinteger必填

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