图片 / GPT 4K 与重建
Image 2 / 2.5 4K · 渠道 B
Image 2 与 Image 2.5 的 4K 按张计费分组。Image 2 显式 quality 档位仅 low / medium / high（med 请填写 medium），不支持 xhigh / max；三档同价。Image 2.5 沿用现有线路与参数。
分组 #170「【GPT 生图】Image 2 / 2.5 4K · 渠道 B」 · Key 需属于该分组
文生图图生图4K多参考图quality 参数
价格—
24 小时成功率—
最近 24 小时
可用模型
| 模型 | 说明 | 价格 |
|---|---|---|
gpt-image-2 | 按张 $0.06（1K / 2K / 4K 同价） | — |
gpt-image-2.5-flare | 按张 $0.18（1K / 2K / 4K 同价） | — |
gpt-image-2.5-sunburst | 按张 $0.18（1K / 2K / 4K 同价） | — |
接口
POST /v1/images/generations | 文生图，JSON |
POST /v1/images/edits | 图生图：multipart 重复上传 image，或 JSON images[].image_url |
GET /v1/models | 用同一把 Key 查询当前分组可用的完整模型名 |
能力与限制
| 计费方式 | 按张：gpt-image-2 $0.06，flare / sunburst $0.18；1K / 2K / 4K 同价（分组倍率 1） |
| 分辨率 / 质量 | 支持 4K；Image 2 仅 low / medium / high（med 请填写 medium），不支持 xhigh / max；Image 2.5 沿用现有线路参数。 |
请求参数
| 字段 | 类型 | 说明 | |
|---|---|---|---|
model | string | 必填 | 完整模型名，见上方模型列表 |
prompt | string | 必填 | 描述生成或编辑目的；多图时说明图1、图2 的用途 |
size | string | 可选 | 宽x高正整数像素，中间是小写 x，例如 3840x2160；实际像素以返回图片为准 |
quality | string | 可选 | Image 2 仅 low / medium / high（med 请填写 medium），不支持 xhigh / max；Image 2.5 沿用现有线路参数。 |
n | integer | 可选 | 输出图片数量，必须写数字；示例填 1 |
response_format | string | 可选 | b64_json 或 url |
image | file | 可选 | 图生图（multipart）参考图，重复上传同名字段 |
images | array | 可选 | 图生图（JSON）参考图对象数组，每项 {"image_url": 图片 URL 或 Data URL} |
注意事项
- 图片模型只能调用 /v1/images/generations 或 /v1/images/edits，不要走 Chat Completions。
- flare / sunburst 与 #153 相同，账号繁忙时可互为备用。
- multipart 请求让 cURL 自动生成请求头，不要手动设置 Content-Type。
- 交付前读取实际文件格式和宽高，不要只看 HTTP 200 或账单中的档位。
- 超时后先检查用量记录，避免重复提交。
常见错误
| 返回 | 原因与处理 |
|---|---|
401 / 403 | Key 错误、已禁用或未绑定该分组；检查 Authorization: Bearer 请求头、绑定分组和访问权限。 |
503 No available compatible accounts | 该分组账号暂时全部繁忙或在冷却；稍后重试，或换用同模型的其他分组。 |
502 Upstream service temporarily unavailable · Upstream request failed | 上游短暂故障；稍后重试，先在使用记录确认没有成功结果，避免重复生成。 |
502 Upstream access forbidden, please contact administrator | 上游账号受限；联系管理员，同时可先换用同模型的其他分组。 |
451 The generated images appear to be unsafe… · prompt or image unsafe | 提示词、参考图或生成结果触发内容安全审核；修改描述或更换参考图后重试。 |
429 Upstream rate limit exceeded, please retry later | 上游限流；按指数退避重试，并降低并发。 |
400 This model is not supported on the Chat Completions endpoint | 图片模型请调用 /v1/images/generations 或 /v1/images/edits，不要走 Chat Completions。 |