文生图
用一段文字生成图片。
不写代码?见用你自己的工具生图。
开始前
代码里要用到的
API 地址
https://api.ofox.ai/v1模型 ID
openai/gpt-image-2.5-flareAPI Key把代码里的 YOUR_OFOX_API_KEY 换成你的 Key
Python 依赖
pip install openai示例代码
以下代码都原样运行通过,结果保存为当前目录下的 output.png。
cURL
Terminal
curl -s https://api.ofox.ai/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)
- 尺寸
size:宽、高都是 16 的倍数,最长边 ≤ 3840,宽高比在 1:3 到 3:1 之间,总像素 ≥ 655,360。768x768不行,1024x768可以。不传时由模型决定,实测是 1254×1254。详见尺寸。 - 画质
quality:先用low跑通再调高。不传不等于medium,由模型自己选。gpt-image-2没有xhigh和max。各档消耗见画质。
参数取值
下面是本系列各参数的可选值和实测默认值。size 和 quality 见概览页的尺寸、画质两节。
必填
区分大小写,写错会返回 404。建议带上 openai/ 前缀写全。
常用
每张单独计费。超过 10 返回 400。
三种格式实测均可用。
▶高级 · 4output_compression · background · moderation · partial_images展开
只对 jpeg 和 webp 生效。
透明背景要配合 png 或 webp 使用,jpeg 不支持透明。
内容审核的严格程度。
配合 stream: true 使用,表示生成过程中返回几张中间图。
常见报错
其他报错见完整报错表。
官方文档
OpenAI 官方文档写的是直连 OpenAI 时的行为。在 OfoxAI 上调用,以本系列文档的实测结论为准,例如改图不需要指定供应商。
Last updated on