文档

API 参考

取得短时文件下载地址

GET/v1/files/{file_id}/download-url

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

播放与下载

先读取文件状态，再请求短时下载地址；存储未 ready 时，获取地址不能让文件提前可用。原 Key 只发到 GloopAPI，向返回的 HTTPS 地址下载时不要附带它。

持久视频使用短时对象存储 URL 支持原生 Range 播放；普通视频 content 路径的完整 GET 与这一播放器传输不同。链接过期后重新获取地址，文件过期或被删除则不能靠刷新链接恢复。

鉴权与权限

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

Authorization: Bearer $GLOOP_API_KEY

鉴权方案： BearerAuth

请求

路径参数

  • file_idstring必填

    同 Key 的托管文件公开 ID。

响应与错误

HTTP 200

取得短时文件下载地址成功

application/json

类型
object
必填字段
urlexpires_at
  • urlstring必填

    短时签名下载地址，请勿泄露或长期保存。

    格式
    "uri"
  • expires_atinteger必填

    Unix 秒。

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