文档

API 参考

查询持久图像能力

GET/v1/image-models

目录当前支持 Ark Seedream Pro/Lite 与 Qwen；未合入的 Venice 持久工作区修复不在本基线。返回开关与同 Key 可执行能力；生产上架不是目录承诺。

鉴权与权限

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

Authorization: Bearer $GLOOP_API_KEY

鉴权方案： BearerAuth

响应与错误

HTTP 200

查询持久图像能力成功

application/json

类型
object
必填字段
workspace_enabledfile_storage_enableddataupload_enabled
  • workspace_enabledboolean必填

    当前工作区新任务功能是否可用，不表示历史对象被删除。

  • file_storage_enabledboolean必填

    服务是否启用托管文件存储。

  • dataarray必填

    当前页/目录数据数组。

    data 子字段（1）
    • []object选填
      [] 子字段（8）
      • idstring必填

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

      • namestring必填

        用户可读名称。

      • providerstring必填

        能力目录的提供方名称，用于展示模型信息。

      • max_referencesinteger必填

        所选模型允许的最大参考图数量。

      • max_ninteger必填

        所选模型允许的最大输出张数。

      • sizesarray必填

        此模型允许的尺寸列表。

        sizes 子字段（1）
        • []object选填
          [] 子字段（2）
          • valuestring必填

            实际提交的尺寸值。

          • labelstring必填

            尺寸的显示名称。

      • versionstring必填

        契约/能力或工具版本；运行使用目录返回的工具版本。

      • outputstring必填

        工具输出的 JSON 或模型输出形式，由对应 schema/能力定义。

  • upload_enabledboolean必填

    服务是否启用参考图上传。

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