GPT Image 2 API 调用
一、接口地址与鉴权
TeamoRouter 使用 OpenAI Images API 兼容格式：
- 生成图片：
POST https://api.teamorouter.com/v1/images/generations - 编辑图片：
POST https://api.teamorouter.com/v1/images/edits
在请求头中携带 API Key：
Authorization: Bearer sk-teamo-xxxxxx
Content-Type: application/json
编辑接口也支持 multipart/form-data，用于上传图片文件。
二、生成图片
最小请求
curl https://api.teamorouter.com/v1/images/generations \
-H "Authorization: Bearer sk-teamo-xxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "一只在键盘上打字的橘猫，插画风格"
}'
指定尺寸和质量
{
"model": "gpt-image-2",
"prompt": "一只在键盘上打字的橘猫，插画风格",
"size": "2048x2048",
"quality": "high"
}
常用参数
| 参数 | 说明 |
|---|---|
model |
使用 gpt-image-2。未传时 TeamoRouter 默认使用该模型。 |
prompt |
生图描述。 |
size |
auto 或宽 x 高，例如 1024x1024、2048x2048、3840x2160。 |
quality |
low、medium、high 或 auto。 |
n |
一次生成的图片数量，默认 1。 |
output_format |
png、jpeg 或 webp。 |
output_compression |
JPEG/WebP 压缩等级，范围为 0 到 100。 |
OpenAI 对 gpt-image-2 的尺寸约束是：最大边不超过 3840 像素；宽高均为 16 的倍数；长宽比不超过 3:1；总像素数在 655,360 到 8,294,400 之间。尺寸不是固定的 1k、2k、4k 字符串，而是像素尺寸。
三、编辑图片
curl https://api.teamorouter.com/v1/images/edits \
-H "Authorization: Bearer sk-teamo-xxxxxx" \
-F "model=gpt-image-2" \
-F "prompt=把背景替换成雪山" \
-F "image=@input.png" \
-F "size=1024x1024"
四、TeamoRouter 尺寸规则
TeamoRouter 会读取请求体中的 size 字段，并按以下规则选择模型队列：
| 请求体情况 | 选择模型队列 |
|---|---|
没有 size 参数 |
默认生成1K |
size 中包含 1024，例如 1024x1024、1024x1536、1536x1024 |
生成1K |
传入 size 且不包含 1024，例如 2048x2048、2048x1152、3840x2160 |
生成对应尺寸图片 |
这里的“包含 1024”指宽或高任意一边等于 1024。判断依据是请求参数，不是生成结果文件的实际宽高。
示例：
未传 size -> 默认生成1K
1024x1024 -> 生成1K
1024x1536 -> 生成1K
1536x1024 -> 生成1K
2048x2048 -> 生成对应尺寸图片
2048x1152 -> 生成对应尺寸图片
3840x2160 -> 生成对应尺寸图片
size: "auto" 的处理，auto 是 OpenAI 支持的合法值，根据需求自动识别尺寸，默认打到生成4K渠道
