gpt-image-1 API 接入教程:价格、调用示例与免费额度(2026)

想在自己的产品里加一个”输入文字出图”的功能,gpt-image-1 是目前指令遵循和图内文字渲染最稳的一档模型。下面用 GetModel 的 OpenAI 兼容接口把它跑通——把 base_url 换成 https://getmodel.ai/v1,一个 Key 同时还能调 Claude、GPT、Gemini,新用户有免费额度可以先免费试跑 gpt-image-1。

什么是 gpt-image-1

gpt-image-1 是 OpenAI 的原生多模态图像生成模型,通过 /v1/images/generations 端点调用。相比上一代 DALL·E 3,它的强项是:

• 指令遵循更准:多主体、构图、相对位置的描述更容易被正确还原;
• 图内文字渲染更清晰:海报、UI、logo 里的文字不再糊成乱码;
• 支持图生图与局部重绘:通过 images.edit 端点传参考图 + 蒙版做编辑。

实时价格与可用性,可查其后继款 gpt-image-2 模型页。

⏳ 时效提示(2026):gpt-image-1 计划于 2026-12-01 从 OpenAI API 下线,官方建议迁移到 gpt-image-2。用 GetModel 聚合接口的好处是:届时只需把代码里的 model 从 gpt-image-1 换成 gpt-image-2,鉴权、SDK、请求结构都不用动。

快速上手:gpt-image-1 怎么用

先在 GetModel 控制台 的「API 令牌」页获取一个 API Key(形如 sk-...),接口地址统一是 https://getmodel.ai/v1。

⚠️ 关键点:gpt-image-1 只返回 base64(b64_json),不返回图片 URL。别去读 data[0].url——那是空的。

Python

from openai import OpenAI
import base64

client = OpenAI(
    api_key="sk-你的Key",
    base_url="https://getmodel.ai/v1",
)

resp = client.images.generate(
    model="gpt-image-1",
    prompt="一只戴着宇航头盔的柴犬,漂浮在星空里,扁平插画风格",
    size="1024x1024",   # 或 1536x1024 横 / 1024x1536 竖
    quality="high",      # low | medium | high
    n=1,
)

img_b64 = resp.data[0].b64_json
with open("dog.png", "wb") as f:
    f.write(base64.b64decode(img_b64))

Node.js

import OpenAI from 'openai';
import { writeFileSync } from 'node:fs';

const client = new OpenAI({
  apiKey: 'sk-你的Key',
  baseURL: 'https://getmodel.ai/v1',
});

const resp = await client.images.generate({
  model: 'gpt-image-1',
  prompt: 'A neon cyberpunk street in the rain, cinematic lighting',
  size: '1536x1024',
  quality: 'medium',
});

const b64 = resp.data[0].b64_json!;
writeFileSync('city.png', Buffer.from(b64, 'base64'));

cURL

curl https://getmodel.ai/v1/images/generations \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "一杯拉花拿铁的特写,暖色调,45 度俯拍",
    "size": "1024x1024",
    "quality": "high"
  }'

返回的 JSON 里,图片在 data[0].b64_json 字段,base64 解码后写文件即可。

常用参数

参数	取值	说明
size	1024x1024 / 1536x1024 / 1024x1536	方形 / 横版 / 竖版,只能三选一
quality	low / medium / high	质量越高越慢越贵,默认 high
n	整数	一次生成几张
output_format	png / jpeg / webp	输出格式,默认 png
background	transparent / opaque / auto	透明背景需搭配 png/webp
moderation	auto / low	审核强度,low 更宽松

价格:官方计费对照

gpt-image-1 按 token 计费,生成的图片折算成”图像输出 token”。官方费率:

类型	单价(每 100 万 token)
文本输入	$5.00(缓存 $1.25)
图像输入	$10.00(缓存 $2.50)
图像输出	$40.00

换算成”单张多少钱”更直观:

质量	方形 1024×1024	横/竖 1536×1024
low	$0.011	$0.016
medium	$0.042	$0.063
high	$0.167	$0.25

也就是说,批量出低质量草图约 $0.01 一张,高质量成图约 $0.17 一张(按当前汇率分别约 ¥0.08、¥1.2)。GetModel 按官方同规则透传计费,不加价、余额全模型共享,用量在控制台「日志」页逐条可查。实时价格与其他模型对照见价格页。

常见报错排查

现象	原因 & 解决
401 invalid_api_key	Key 写错,或没带 Authorization: Bearer sk-...
400 关于 size/quality	size 只能三选一;quality 只能 low/medium/high
content_policy_violation	prompt 触发审核,改写描述,或加 "moderation": "low"
拿到的图是空的	别读 data[0].url——gpt-image-1 只有 data[0].b64_json
429 限流	触发速率限制,加指数退避重试;网关侧已内置多渠道故障转移
请求超时	high 质量生成较慢,把客户端 timeout 拉到 120s 以上

FAQ

• 能做图生图 / 局部重绘吗? 可以。用 client.images.edit(),传入 image(原图)、可选 mask(蒙版,透明区域会被重绘)和 prompt。
• 能要透明背景吗? 可以。设 background="transparent",并把 output_format 设为 png 或 webp。
• 能不能直接返回 URL? 不能。gpt-image-1 固定返回 base64,需要 URL 请自己上传到对象存储后再拿链接。
• 和官方直连有什么区别? 调用方式、参数、计费规则完全一致(OpenAI 兼容),差别只在于:一个 Key 同时管 Claude / GPT / Gemini / gpt-image-1,余额共享、低延迟直连、有免费额度。
• 免费额度怎么领? 注册即送,登录控制台即可查看余额并创建 Key,先跑通再充值。

---

准备好了就创建 API Key 开始生成,把上面任一段代码里的 sk-你的Key 换成自己的即可。