图片模型:GPT Image 生成、编辑与 Gemini 参考图
本页目录
文生图
在服务端设置 UIUI_API_KEY。主站目录列出 gpt-image-2、gpt-image-2.6-flare 等图片模型。示例请求生成一张方图。
curl -sS --fail-with-body 'https://api.uiuihao.com/v1/images/generations' \
-H "Authorization: Bearer $UIUI_API_KEY" \
-H 'Content-Type: application/json' \
--data-binary '{
"model": "gpt-image-2",
"prompt": "咖啡馆窗边的瓷杯,清晨侧光,商业静物摄影。",
"size": "1024x1024",
"n": 1
}'
上传原图编辑
curl -sS --fail-with-body 'https://api.uiuihao.com/v1/images/edits' \
-H "Authorization: Bearer $UIUI_API_KEY" \
-F 'model=gpt-image-2' -F 'image=@product.png' \
-F 'prompt=保留产品外形,将背景替换成浅灰摄影棚'
文件通过 multipart 发送;若通道支持多图,可重复 image[]。尺寸用 宽x高 表示。例如方图 1024x1024,3:2 横图 1536x1024,2:3 竖图 1024x1536。2K、4K、高级质量和 GIF 需按具体型号的通道能力选择;gpt-image-2.6-sunburst 的 GIF 用法为 output_format: "gif",该输出格式尚未在主站实测。
Gemini 原生格式
curl -sS --fail-with-body 'https://api.uiuihao.com/v1beta/models/gemini-3-pro-image-preview:generateContent' \
-H "Authorization: Bearer $UIUI_API_KEY" \
-H 'Content-Type: application/json' \
--data-binary '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "为一副耳机生成横版产品海报,主体居中。"
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "2K"
}
}
}'
加入参考图时,在 parts 中追加 {"inlineData":{"mimeType":"image/png","data":"BASE64_DATA"}}。data 放纯 Base64。Flash 图像型号应使用令牌列表给出的完整 ID。
保存图片
OpenAI 兼容响应通常在 data[] 中给出 url 或 b64_json。Gemini 响应应遍历 candidates[].content.parts[],从 inlineData 中取出 data 和 mimeType。将响应保存为 response.json 后,可用下面的 Python 代码保存 Base64 图片;URL 结果应直接下载。
import base64, json, pathlib
reply = json.loads(pathlib.Path("response.json").read_text(encoding="utf-8"))
for index, item in enumerate(reply.get("data", [])):
if item.get("b64_json"):
pathlib.Path(f"result-{index}.png").write_bytes(base64.b64decode(item["b64_json"]))
elif item.get("url"):
print(item["url"])
上例按默认 PNG 保存;显式请求 JPEG 或 GIF 时应使用相应扩展名。若通道返回异步任务 ID,应按该通道公布的查询入口读取结果。
分辨率与返回类型
| 目标比例 | 1K 参考尺寸 | 2K 参考尺寸 | 4K 参考尺寸 |
|---|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 | 2880x2880 |
| 16:9 | 1536x864 | 3072x1728 | 3840x2160 |
| 9:16 | 864x1536 | 1728x3072 | 2160x3840 |
| 4:3 | 1360x1024 | 2720x2048 | 3328x2496 |
| 3:4 | 1024x1360 | 2048x2720 | 2496x3328 |
| 3:2 | 1536x1024 | 3072x2048 | 3520x2336 |
| 2:3 | 1024x1536 | 2048x3072 | 2336x3520 |
表中为接入端的尺寸映射;按模型开放范围选择。生成或编辑时,可按通道约定显式设置 quality: "auto"、moderation: "auto" 和 output_format。对于将来启用的异步 Images 兼容模式,若只收到 task_id,预期查询地址为 GET https://api.uiuihao.com/v1/images/generations/{task_id}。只有通道明确启用该查询协议时才使用,收到取消、失败或内容过滤状态即停止轮询。