文档

API 参考

查询持久图像历史

GET/v1/image-tasks

同 Key 历史，每页 20 项，使用服务返回的游标；历史仍按当前模型授权检查。

鉴权与权限

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

Authorization: Bearer $GLOOP_API_KEY

鉴权方案： BearerAuth

请求

查询参数

  • cursorstring选填

    原响应 next_cursor，不自行拼造。

  • qstring选填

    提示词搜索，最多 256 UTF-8 字节。

  • statusstring选填

    queued/dispatching/running/succeeded/partial_succeeded/failed/unknown 精确状态过滤。

    枚举
    ["queued","dispatching","running","succeeded","partial_succeeded","failed","unknown"]

响应与错误

HTTP 200

查询持久图像历史成功

application/json

类型
object
必填字段
datanext_cursor
  • dataarray必填

    当前页/目录数据数组。

    data 子字段（1）
    • []object选填
      [] 子字段（17）
      • modelstring必填

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

      • promptstring必填

        生成提示词。

      • sizestring必填

        所选 image-models 返回的尺寸值；能力及尺寸按模型分别校验。

      • ninteger必填

        请求输出张数，仍受所选模型上限约束。

      • referencesarray必填

        生成引用图片列表。

        references 子字段（1）
        • []object选填
          [] 子字段（3）
          • file_idstring选填

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

          • asset_idstring选填

            同账户同 Key 的上传资产 ID。

          • urlstring选填

            公开 HTTPS URL，不允许 userinfo 或 fragment；受 SSRF 校验。

            格式
            "uri"
          oneOf 分支 1

          分支必填： file_id

          oneOf 分支 2

          分支必填： asset_id

          oneOf 分支 3

          分支必填： url

      • source_task_idstring选填

        来源任务公开 ID，仅用于追溯。

      • quote_idstring选填

        报价公开 ID，创建时必须符合价格与请求绑定。

      • idstring必填

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

      • statusstring必填

        unknown 不自动重发，预扣账务可能仍 pending。

        枚举
        ["queued","dispatching","running","succeeded","partial_succeeded","failed","unknown","deleted"]
      • created_atinteger必填

        Unix 秒创建时间。

      • updated_atinteger必填

        Unix 秒最后更新时间。

      • reserved_quotainteger必填

        以平台 quota 单位表示的预留额度，不是美元数。

      • final_quotainteger必填

        以平台 quota 单位表示的最终费用；null 表示尚未确定。

      • billing_statusstring必填

        预留/结算/退回状态，与任务及归档状态分别检查。

      • error_codestring选填

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

      • error_messagestring选填

        经过公开错误分类的用户说明。

      • resultsarray必填

        生成输出项；各项归档状态独立。

        results 子字段（1）
        • []object选填
          [] 子字段（7）
          • file_idstring选填

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

          • storage_statusstring选填

            文件归档状态，ready 后才保证托管下载可用。

          • storage_errorstring选填

            文件归档失败的公开分类。

          • expires_atinteger选填

            Unix 秒有效期，0 表示不按固定时间到期。

          • urlstring选填

            结果或引用的访问 URL；签名 URL 仅短时有效。

          • b64_jsonstring选填

            图片 Base64 字符串；不要当成 URL 请求。

          • revised_promptstring选填

            返回的修订提示词（若有）。

  • next_cursorstring必填

    下一页游标，原样用于该接口的分页参数；空值表示末页。

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