文档

API 参考

同步生成图像

POST/v1/images/generations

同步请求依模型校验参数；仅所选模型支持的图片能力可用。Qwen 最多 6 张/3 参考图，Ark 根据型号限制；Venice 文生图单张，不支持参考图。普通 API 文件按存储天数策略，不等同于持久图像任务。

同步输出的使用边界

Qwen 支持最多 6 张输出和 3 张参考图；Ark 限制随型号变化，Venice 只提供单张文生图。先选择模型，再按对应字段发送，不能把参考图请求发到不支持它的模型。

需要报价确认、长期历史和断线恢复时，使用持久图像工作流而不是同步生成后自动重复请求。同步响应中的文件归档头仅说明保存阶段；普通文件保留与任务引用保护不同，见计费。

鉴权与权限

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

Authorization: Bearer $GLOOP_API_KEY

鉴权方案： BearerAuth

请求

请求体 · application/json

类型
object
必填字段
modelprompt

请求体必填

  • image_urlsarray选填

    模型相关参考图 URL 列表；Qwen/Ark 有各自限制，Venice 同步文生图拒绝此字段。

    image_urls 子字段（1）
    • []string选填
  • modelstring必填

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

  • promptstring必填

    生成提示词。

  • ninteger选填

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

  • sizestring选填

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

  • response_formatstring选填

    模型相关输出格式，不能假定每个模型支持所有格式。

  • userunknown选填

    由所选工具的 schema 或协议定义的 JSON 值；不假定固定字段。

  • extra_bodyunknown选填

    由所选工具的 schema 或协议定义的 JSON 值；不假定固定字段。

响应与错误

HTTP 200

同步生成图像成功

application/json

类型
object
必填字段
createddata
  • createdinteger必填

    Unix 秒图像响应生成时间。

  • dataarray必填

    当前页/目录数据数组。

    data 子字段（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选填

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

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