GPT-Image-2 官方渠道

gpt-image-2-official 官方模型，支持 quality、mask 重绘与多图生成。

GPT-Image-2 官方渠道图像生成

模型名：gpt-image-2-official（固定，OpenAI 官方 gpt-image-2）
接口：POST https://apimaster.ai/v1/images/generations
能力：文生图、图生图、局部重绘（mask）

与标准渠道的差异

能力	`gpt-image-2`	`gpt-image-2-official`
参考图	URL + base64 混填	公网 URL，最多 16 张
生成张数 `n`	`1`	`1` ~ `4`
`quality`	—	`auto` / `low` / `medium` / `high`
`mask_url` 局部重绘	—	支持（需配合 `image_urls`）
`background` / `output_format` 等	—	支持

请求参数（补充）

除标准版共有的 prompt、size、resolution、image_urls 外：

字段	类型	默认	说明
`quality`	string	`auto`	`low` / `medium` / `high`；4K + high 可能 >120s
`background`	string	`auto`	`opaque` / `transparent`（official 不支持透明，会降级为 `auto`）
`moderation`	string	`auto`	`low` 为更宽松审核
`output_format`	string	`png`	`jpeg` / `webp`
`output_compression`	integer	—	0–100，仅 jpeg/webp
`n`	integer	`1`	1–4 张
`mask_url`	string	—	遮罩图 URL，局部重绘；尺寸须与首张参考图一致，需带 Alpha

size × resolution 像素映射与标准版相同（15 比例 × 1k/2k/4k）。

请求示例

文生图（最简）

{
  "model": "gpt-image-2-official",
  "prompt": "星空下的古老城堡"
}

2K 高清海报

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-official",
    "prompt": "赛博朋克夜景",
    "size": "16:9",
    "resolution": "2k",
    "quality": "high",
    "output_format": "jpeg",
    "output_compression": 90
  }'

4K 壁纸

{
  "model": "gpt-image-2-official",
  "prompt": "雪山日出全景",
  "size": "16:9",
  "resolution": "4k",
  "quality": "high",
  "n": 1
}

图生图（多参考图）

{
  "model": "gpt-image-2-official",
  "prompt": "将两张参考图融合成一张插画海报",
  "size": "1:1",
  "quality": "high",
  "image_urls": [
    "https://your-cdn.com/input-a.png",
    "https://your-cdn.com/input-b.png"
  ]
}

局部重绘（mask）

{
  "model": "gpt-image-2-official",
  "prompt": "把背景换成沙漠日落",
  "size": "1:1",
  "quality": "medium",
  "image_urls": ["https://your-cdn.com/photo.png"],
  "mask_url": "https://your-cdn.com/mask.png"
}

一次生成 4 张

{
  "model": "gpt-image-2-official",
  "prompt": "Four minimalist poster variations of a red fox",
  "size": "1:1",
  "quality": "low",
  "n": 4
}

提交响应

与标准版相同，返回 task_id：

{
  "code": 200,
  "data": [{ "status": "submitted", "task_id": "task_01KPTXXXXXXXXXXXXXXX" }]
}

另可能返回 403（权限 / 模型未开通）。

查询任务结果

curl -s "https://apimaster.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

状态流转：submitted → processing / in_progress → completed / failed。

取图：data.result.images[0].url[0]（多图时遍历 images 数组）。

轮询建议

首次查询延迟 10–20 秒，间隔 3–5 秒
quality: high + 2k/4k 可达 130 秒，客户端超时建议 ≥ 180 秒
批量：POST https://apimaster.ai/v1/tasks/batch

注意事项

mask_url 须与首张参考图同尺寸，遮罩需有 Alpha 通道。
不要对 official 模型期望透明背景；transparent 会被静默改为 auto。
账户须已开通 gpt-image-2-official，可在控制台或 GET https://apimaster.ai/v1/models 确认。
失败、审核拒绝 generally 不扣费，以账单为准。

GPT-Image-2 官方渠道 图像生成