GPT-Image-2 API：以 $0.02 起生成和编辑图像 — 可用的最低成本访问

OpenAI 刚刚发布了 GPT-Image-2，这是他们新的旗舰图像生成和编辑模型。我们在同一天把它接入了 Smart AIPI。你可以在任何 /v1/images/generations 或 /v1/images/edits 调用中使用 model ID gpt-image-2——无需改配置、无需重新部署、使用同一个 API key。

下面会说明它与 gpt-image-1.5 相比到底改了什么、为什么 multi-reference edits + mask inpainting 对生产环境很重要、准确的定价，以及四种语言的可运行代码。

GPT-Image-2 有什么不同

GPT-Image-2 是第一个适合严肃创意工作流部署的 OpenAI 图像模型——不只是一次性 demo。下面四项能力变化是核心：

• 原生 4K 分辨率。 GPT-Image-2 接受任意尺寸，最高可达 3840×2160（4K 横向）或 2160×3840（4K 纵向），而 gpt-image-1.5 的上限是 1536×1024。最大输出像素提升了 7.5 倍。现在你可以在一次工具调用中生成可直接用于生产的主视觉、印刷级海报和电影感静帧。
• 自由分辨率。 之前的 gpt-image 模型只能选三个预设（方形、横向、纵向）。GPT-Image-2 接受任意 WxH，只要两边都是 16 的倍数，最长边 ≤ 3840px，总像素在 655,360 到 8,294,400 之间，长边与短边比例 ≤ 3:1。它覆盖了成千上万种长宽比——横幅、社交裁切、app 图标、书封、电影画幅。
• 默认高保真 reference 处理。 旧的 input_fidelity: "high" 标志现在始终开启。你传入的每张 reference image 都会以完整细节处理——品牌 logo 保持清晰、产品纹理在编辑后依然保留、角色脸部在多轮编辑中仍可辨认。你不需要再在质量和速度之间做权衡。
• 更快的低质量草稿。 在 1024×1024 下，quality: "low" 通过 Smart AIPI 只要 $0.003，返回时间大约 20–40 秒。这个价格足够低，可以直接丢弃——非常适合在锁定 $0.10+ 的高质量渲染前做 prompt 探索和 UI 预览。

定价：比 OpenAI 直连便宜 50%

OpenAI 的 GPT-Image-2 直连 API 定价在 1024×1024 时为 low $0.006 / medium $0.053 / high $0.211。非方形尺寸（1024×1536、1536×1024）按方形价格的 1.5 倍计费。

通过 Smart AIPI，每个档位都正好是 OpenAI 零售价的 50%：

一个典型的创意迭代周期——10 张 1024×1024 的低质量草稿，再加 1 张 1536×1024 的高质量最终渲染——通过 Smart AIPI 只需 $0.19，而 OpenAI 直连要 $0.38。如果一个工作室每天做 100 组这样的周期，你每月可节省 $570，而且几乎不需要额外成本。

没有其他提供商以这个折扣提供 GPT-Image-2。OpenRouter 只是转发 OpenAI 直连价格再加一层利润。Fal、Replicate 和 Vertex 根本不托管 OpenAI 模型。Smart AIPI 聚合了 ChatGPT Business 订阅中的图像容量，并把节省直接传递给你。

Multi-Reference Edits：可组合的创意工作流

GPT-Image-2 的 edit endpoint 支持在一次调用中传入多张 reference images。这个能力打开了真正的创意工作流——产品合成、跨场景保持品牌一致的角色、拼贴生成。

Smart AIPI 支持官方 OpenAI SDK 发送这些图片的所有方式：

Python SDK（multipart with image[]）

from openai import OpenAI
client = OpenAI(base_url="https://api.smartaipi.com/v1")

result = client.images.edit(
    model="gpt-image-2",
    image=[
        open("body-lotion.png", "rb"),
        open("bath-bomb.png",  "rb"),
        open("incense-kit.png","rb"),
        open("soap.png",       "rb"),
    ],
    prompt="Photorealistic gift basket 'Relax & Unwind' with a ribbon, containing the items in the reference images.",
)

with open("gift-basket.png","wb") as f:
    f.write(base64.b64decode(result.data[0].b64_json))

JSON API（base64 字符串数组）

curl https://api.smartaipi.com/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Gift basket containing all the items from the references",
    "image": ["<base64-png-1>", "<base64-png-2>", "<base64-png-3>"]
  }'

curl multipart（image[] 和重复 image 都支持）

curl https://api.smartaipi.com/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-2" \
  -F "image[][email protected]" \
  -F "image[][email protected]" \
  -F "image[][email protected]" \
  -F "image[][email protected]" \
  -F "prompt=Gift basket with all the referenced items"

Mask Inpainting：精确编辑

在 image 旁边传入 mask，即可将编辑限制在特定区域。mask 中的白色像素表示要重写的区域；黑色像素将保持不变。

curl https://api.smartaipi.com/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-2" \
  -F "image=@sunlit_lounge.png" \
  -F "[email protected]" \
  -F "prompt=Replace the pool with a flamingo float"

mask 格式要求：与主图像像素尺寸相同，带 alpha channel 的 PNG，大小 ≤ 50MB。如果你的源 mask 是没有透明度的 RGB，OpenAI 文档里有一个 10 行的 PIL 片段，可以从灰度值添加 alpha channel。

Generate：基础请求

curl https://api.smartaipi.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A photorealistic coffee mug on a weathered oak table",
    "size": "2048x2048",
    "quality": "high"
  }'

响应格式与 OpenAI 标准一致——{ "created": ..., "data": [{ "b64_json": "..." }] }。对 b64_json 做 Base64 解码即可得到 PNG 字节。

输出格式：PNG、JPEG、WebP

使用 output_format 控制容器格式。JPEG 的回传速度明显快于 PNG，当延迟比无损更重要时，它是更合适的默认选择。将 JPEG 或 WebP 与 output_compression（0–100）搭配，可调整文件大小。

{
  "model": "gpt-image-2",
  "prompt": "Cinematic landscape, golden hour",
  "size": "3840x2160",
  "quality": "high",
  "output_format": "jpeg",
  "output_compression": 85
}

支持的参数（v1/images/generations & v1/images/edits）

• model — gpt-image-2（默认）、gpt-image-1.5、gpt-image-1、gpt-image-1-mini。旧别名 dall-e、dall-e-3、gpt-image、gpt-image-latest 都会映射到 gpt-image-2。
• prompt — 必需的文本指令。
• n — 批量大小，1–10。因为 Codex image tool 每次调用只产出 1 张图，所以 Smart AIPI 在服务端循环处理。
• size — auto 或任何满足 gpt-image-2 约束的 WxH（16 的倍数、边长 ≤ 3840、655,360 ≤ 像素 ≤ 8,294,400、长边:短边 ≤ 3:1）。
• quality — low / medium / high / auto（默认 medium）。
• output_format — png（默认）/ jpeg / webp。
• output_compression — 0–100，仅适用于 jpeg/webp。
• background — auto / opaque。gpt-image-2 不支持 transparent；如果你需要透明背景，请使用 gpt-image-1.5。
• moderation — auto（默认）/ low。
• image（仅 edits）— 单个 base64 字符串或 base64 字符串数组（JSON）/ image 或 image[] multipart 文件部分。
• mask（仅 edits）— 单个 base64 字符串（JSON）/ multipart 文件。白色=编辑，黑色=保留。

响应结构

与 OpenAI 的 /v1/images 响应完全一致。可选地增加一个字段：如果 Codex 后端输出了 revised_prompt，Smart AIPI 会把它暴露在每个 image item 上。

{
  "created": 1777064910,
  "data": [
    {
      "b64_json": "iVBORw0KGgo...",
      "revised_prompt": "A detailed photorealistic coffee mug..."
    }
  ]
}

开始使用

1. 注册：smartaipi.com/signup（免费额度，无需信用卡）
2. 在控制台创建 API key
3. 将 base URL 设置为 https://api.smartaipi.com/v1
4. 使用 model gpt-image-2

相同的 OpenAI-compatible API 结构，相同的 Python / JavaScript / curl 代码，相同的图像生成工具——现在用上了 OpenAI 最新的旗舰图像模型，而且价格减半。