打开链接? 目标地址
继续前往
开发文档

图片模型: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}。只有通道明确启用该查询协议时才使用,收到取消、失败或内容过滤状态即停止轮询。