跳转到主要内容
新项目请直接使用 GPT-Image-2(官方版)或 GPT-Image-2-All(官逆,$0.03/张统一价)。本页面仅保留历史版本的核心参数,方便老项目排查与迁移。

历史版本一览

模型 ID发布时间端点价格特点状态
gpt-image-1.52025年12月/v1/images/generations输入 $5.00 / 输出 $10.00 / 百万 tokens仍可用,建议升级至 gpt-image-2
gpt-image-12025年4月/v1/images/generations/v1/images/edits输入 $2.50 / 输出 $8.00 / 百万 tokens仍可用,建议升级至 gpt-image-2
gpt-image-1-mini2025年4月/v1/images/generationsgpt-image-1 更低仍可用
直接迁移:把 model 改成 gpt-image-2gpt-image-2-all 即可,参数(size / quality / output_format 等)大体兼容,无需改代码结构。

通用参数(生图)

历史版本共享一套生图参数:
参数说明
modelgpt-image-1.5 / gpt-image-1 / gpt-image-1-mini
prompt图像描述(最长 1000 字符)
size1024x1024 / 1536x1024 / 1024x1536 / auto
qualitylow / medium / high / auto
output_formatpng(默认) / jpeg / webp
output_compression仅 JPEG / WebP,0–100%
backgroundtransparent / opaque / auto
n生成数量(1–10)

快速调用示例

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"
)

response = client.images.generate(
    model="gpt-image-1.5",  {/* 也可填 gpt-image-1 / gpt-image-1-mini */}
    prompt="A professional product photo on white background, soft studio lighting",
    size="1024x1024",
    quality="high"
)

print(response.data[0].url)

按图片计费参考

GPT-Image-1 / 1.5 同时支持 Token 计费与按图片计费,系统自动取较优方式:

GPT-Image-1.5

质量1024×10241024×1536 / 1536×1024
Low$0.009$0.013
Medium$0.034$0.050
High$0.133$0.200

GPT-Image-1

质量1024×10241024×1536 / 1536×1024
Low$0.005$0.006
Medium$0.011$0.015
High$0.036$0.052
按图片计费仅作参考。实际扣费以系统自动选择的更优方式(Token 或按图片)为准。

图像编辑(仅 gpt-image-1

gpt-image-1 支持基于遮罩的局部编辑端点 /v1/images/edits
response = client.images.edit(
    model="gpt-image-1",
    image=open("original.png", "rb"),
    mask=open("mask.png", "rb"),
    prompt="A modern glass skyscraper with reflective windows",
    size="1024x1024"
)
参数说明
image原图,PNG/WebP/JPG,单张 < 50MB,最多 16 张
mask遮罩图,alpha=0 的区域将被重绘
prompt描述要在遮罩区生成的内容
新项目编辑场景推荐使用 GPT-Image-2 编辑(官方)或 GPT-Image-2-All 编辑(官逆,最多 16 张多图融合)。

迁移到 GPT-Image-2 / 2-All

你的诉求推荐迁移到
沿用 OpenAI 官方端点、需要精确尺寸/质量控制gpt-image-2(官转)
想要可预测的统一价($0.03/张)、提示词遵循更优gpt-image-2-all(官逆)
仍需图像编辑 + 遮罩gpt-image-2-all 编辑端点(支持最多 16 张)

GPT-Image-2 概览

OpenAI 官方最新版,端点 / 参数与历史版兼容

GPT-Image-2-All 概览

官逆通道,$0.03/张统一价,速度更快

官转 vs 官逆 对比

一文看懂两者的差异和选型建议