Skip to Content
模型用法GPT Image文生图

文生图

用一段文字生成图片。

不写代码?见用你自己的工具生图。

POST/v1/images/generations通用参数说明 试一试

开始前

需要准备说明
API Key在 OfoxAI 控制台  创建,替换代码里的 YOUR_OFOX_API_KEY
运行环境cURL 需要装 jq 来解码图片;Python 需要 pip install openai;Node.js 18 及以上,不用装依赖
超时客户端超时设为 600 秒。高画质、大尺寸或改图可能要等好几分钟
代码里要用到的
API 地址https://api.ofox.io/v1
模型 IDopenai/gpt-image-2.5-flare
API Key把代码里的 YOUR_OFOX_API_KEY 换成你的 Key
Python 依赖pip install openai

示例代码

以下代码都原样运行通过,结果保存为当前目录下的 output.png。

Terminal
curl -s https://api.ofox.io/v1/images/generations \ -H "Authorization: Bearer YOUR_OFOX_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "openai/gpt-image-2.5-flare", "prompt": "白色桌面上的一个红苹果,柔和的自然光", "size": "1024x1024", "quality": "low" }' \ -o response.json # 图片以 base64 返回,解码保存(需要 jq;出错时直接看 response.json) jq -r '.data[0].b64_json' response.json | base64 --decode > output.png

常用调整

在上面的请求里改一个参数就行:

想要改这个参数说明
换尺寸size自定义宽高要满足四条约束
画质更好quality档位越高越贵越慢,见画质
文件更小output_format、output_compression改用 jpeg 或 webp,再调压缩率
一次多张n1–10 张,每张单独计费

尺寸(size)和画质(quality)

  • 尺寸 size:宽、高都是 16 的倍数,最长边 ≤ 3840,宽高比在 1:3 到 3:1 之间,总像素 ≥ 655,360。768x768 不行,1024x768 可以。不传时由模型决定,实测是 1254×1254。详见尺寸。
  • 画质 quality:先用 low 跑通再调高。不传不等于 medium,由模型自己选。gpt-image-2 没有 xhigh 和 max。各档消耗见画质。

参数取值

下面是本系列各参数的可选值和实测默认值。size 和 quality 见概览页的尺寸、画质两节。

必填
model必填string· 可选openai/gpt-image-2.5-flareopenai/gpt-image-2.5-sunburstopenai/gpt-image-2

区分大小写,写错会返回 404。建议带上 openai/ 前缀写全。

常用
ninteger· 默认 1· 可选1–10

每张单独计费。超过 10 返回 400。

output_formatstring· 默认 png· 可选pngjpegwebp

三种格式实测均可用。

▶高级 · 4output_compression · background · moderation · partial_images展开
output_compressioninteger· 可选0–100

只对 jpeg 和 webp 生效。

backgroundstring· 默认 opaque· 可选opaquetransparentauto

透明背景要配合 png 或 webp 使用,jpeg 不支持透明。

moderationstring· 可选autolow

内容审核的严格程度。

partial_imagesinteger· 可选0–3

配合 stream: true 使用,表示生成过程中返回几张中间图。

常见报错

报错原因怎么处理
moderation_blocked提示词被上游安全系统拦截修改提示词后再试,原样重试结果不变
Transparent background is not supported for JPEG output format透明背景配了 jpeg改用 png 或 webp
404 model_not_found模型 ID 拼错或大小写不对从本页复制模型 ID
Invalid size尺寸不满足上面的四条约束按尺寸和画质调整
does not support quality 'xhigh'gpt-image-2 传了 xhigh 或 max改用 high,或换 2.5
Invalid value: 'standard'quality 传了 standard 或 hd改用 low 到 max
429 rate_limit_exceeded超过每分钟 100 次(按团队合计)稍后重试

其他报错见完整报错表。

官方文档

OpenAI 官方文档写的是直连 OpenAI 时的行为。在 OfoxAI 上调用,以本系列文档的实测结论为准,例如改图不需要指定供应商。

Last updated on