跳到正文
HopBase 文档
登录控制台

图片总览

用 OpenAI Images 兼容接口生成和编辑图片。

用途端点
Base URLhttps://api.hop-base.com/v1
生成图片POST /v1/images/generations
编辑图片POST /v1/images/edits
查询异步任务GET /v1/images/tasks?task_id=…

调用 GPT Image 需要「GPT Image 全系」分组的密钥；其中 gpt-image-2.5-flare 与 gpt-image-2.5-sunburst 也可以用「GPT 官方直连(Azure)」分组的密钥，同步返回 Base64。其他系列见「选择系列」。

三行生成第一张图

在控制台「API 密钥」页用「GPT Image 全系」分组创建密钥。不含该分组的密钥（例如只有 Codex Plus / Codex Pro）调 gpt-image-* 会返回 404；也可以在已有密钥上加上这个分组。

把 sk-你的密钥 换成新密钥后执行。curl 示例需要先安装 jq。

curl https://api.hop-base.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只柴犬坐在樱花树下，日系水彩风格",
    "size": "1024x1024"
  }' \
  | jq -r '.data[0].b64_json' | base64 --decode > result.png

图片以 Base64 放在 data[].b64_json，解码后就是 PNG。单张通常 15–40 秒，客户端读超时请设为不少于 300 秒（原因见 GPT Image）。

选择系列

各系列分属不同套餐分组，能调通其中一个的密钥不代表能调通其他。参数、返回与报错见各系列页。

系列特点调用方式参考图上限官方价（代表型号）
GPT Image支持 mask 局部重绘；按 token 计费同步；可异步16 张（官方）$5 / $30/ 百万 tokens
Gemini 生图1K–4K 档位，任意比例 宽x高同步；可异步14 张（官方）$0.1344起/ 张
Seedream返回 24 小时有效的 URL 或 b64_json同步；Lite / 4.5 可流式14 张$0.045起/ 张
Grok Imagine 生图不使用 size，返回临时 URL仅同步2 张$0.02/ 张
可灵生图多个型号，含扩图与多参考图异步0–10 张，按型号$0.0294/ 张
Midjourney每次固定出 4 张异步1 张$0.0067起/ 张

发付费请求前，用实际要使用的密钥调 GET /v1/models，从返回结果里取完整模型 ID。各系列的分组见系列页开头的速查表。

共用规则

鉴权与请求体

所有端点都使用 Authorization: Bearer sk-你的密钥，Base URL 是 https://api.hop-base.com/v1。整个请求体上限 60 MB，超过返回 413。

Gemini 生图也用 OpenAI Images 结构。不要传 Gemini native generateContent payload，HopBase 会根据所选模型自动完成协议适配。

同步与异步

方式适用系列取结果
同步（默认）GPT Image、Gemini、Seedream、Grok响应体的 data[]
异步（加 Prefer: respond-async）GPT Image、GeminiGET /v1/images/tasks?task_id=…
一律异步可灵、MidjourneyGET /v1/video/tasks/{task_id}

生成 2K / 4K 大图时建议用异步，可避免长时间请求被 CDN 超时中断。Seedream 忽略 Prefer 照常同步返回。

传参考图

系列字段与写法
GPT Image/v1/images/edits 的 image，或 multipart image[]
Geminigenerations 的 image / images；「Gemini 全系（含生图）」也可用 edits
Seedreamgenerations 的 image；本地文件走 edits multipart
Grok Imagine/v1/images/edits 的 image 或 image[]
可灵 / Midjourneyimages: [{"url": …}] 或 [{"file_id": …}]

URL 必须能被服务端取得，不是浏览器登录后才能存取的页面，也不能指向内网地址。Data URL 须是完整编码，MIME 与图片匹配，例如 data:image/png;base64,iVBORw0KGgo…。

asset:// 仅用于Seedance 2.0 素材库，不能用于任何图片系列。

计费

实际扣费 = 官方价 × 分组倍率，以控制台「使用记录」为准。参数不合规的 400 在生成前返回，不计费；各系列的计费单位见系列页。

单价见各模型卡与登录后的模型广场。

下一步

本页目录

三行生成第一张图选择系列共用规则鉴权与请求体同步与异步传参考图计费下一步