图片请求构建器 | HopBase 文档

选模型、填参数，实时得到可运行的请求和代码。只列出该模型支持的参数；上下限、枚举和报错原文都取自网关校验代码。

model必填

GPT Image 全系

prompt必填不能为空（首尾空白不计） · 官方上限 32,000 字符

size可选边长为 16 的倍数，单边 ≤ 3840

总像素 655,360–8,294,400，长短边比 ≤ 3:1。不合规在生成前返回 400，不计费。

quality可选默认 auto，原样转发

档位越高，输出 token 越多，费用越高

n可选1–10（官方范围）

部分分组只支持 1 张，批量前请先确认

background可选默认 auto

output_format可选默认 png

moderation可选默认 auto；low 不会关闭安全检查

image可选1–16 张（官方上限）

0 / 16

带参考图时改用 POST /v1/images/edits；远程 URL 单张 ≤ 25 MiB，且须返回 image/*

传入不生效

response_format
始终返回 b64_json，请省略
partial_images
不支持渐进式图片事件，请省略

POST /v1/images/generations

curl https://api.hop-base.com/v1/images/generations \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "白底商品主图：一只不锈钢保温杯，柔和棚拍光，主体居中",
    "size": "1024x1024"
  }'

$0.006–0.0528

auto 档未实测，按 low–high 区间 × 1 张（输出 $30/百万 token）

官方价估算，实际扣费 = 官方价 × 分组倍率

查看此模型的 SchemaJSON Schema 全部模型索引 OpenAPI 3.1

…

机器可读规格

构建器使用的规格同时以 JSON Schema（draft 2020-12）和 OpenAPI 3.1 发布。编程 AI 可以按 Schema 生成并自检请求：必填项、类型、上下限、枚举、条件规则（例如 Gemini 各档位的张数上限）和会返回 400 的字段都在里面；x-hopbase 另附可用分组、官方价和数据出处。

/spec/models/index.json：全部生图模型的规格索引
/openapi.json：POST /v1/images/generations 与 POST /v1/images/edits，请求体引用各模型的 Schema

数据来源：参数规格取自 spec/openai.json、spec/gemini.json、spec/seedance.json（由网关插件从校验代码导出）与 spec/official.json；价格取自公开定价接口快照。费用均按官方价估算，实际扣费 = 官方价 × 分组倍率。