GPT K档系列
模型与价格
- 以上模型均支持文生图和图片编辑；
- 单次生成
1张图片，编辑时最多使用9张参考图片，并可额外提供1张蒙版； - 支持同步和异步调用，新接入推荐使用异步；
- 参考图片和蒙版请使用可访问的 HTTPS 地址；
- 通过模型名称选择 1K、2K、4K 档位，图片尺寸应符合所选档位的限制；
接口
请求参数
- 参考图片仅传公网可访问的 HTTPS URL，不要调用 /v1/files；
- 不要发送 aspect_ratio、image_size、output_resolution，以及本表未列出的字段；
- model 字段必须使用上方列表中的完整名称，保持大小写及符号一致；
- 不同模型的请求格式相同，切换模型时请确认 size 符合所选档位的限制；
- 模型档位由 model 选择，不能通过提高 size 或 quality 将低档模型升级为高档模型；
异步请求示例
文生图
请求端点：POST /v1/images/generations
{
"model": "gpt-image-2-1k",
"prompt": "一座临海的白色建筑，午后阳光，简洁构图，真实摄影风格。",
"n": 1,
"size": "1:1",
"quality": "high",
"response_format": "url",
"async": true
}图片编辑
请求端点：POST /v1/images/edits
{
"model": "gpt-image-2-1k",
"prompt": "保留参考图片中的建筑主体，将场景改为傍晚，窗户透出温暖灯光。",
"images": [
"https://example.com/reference.png"
],
"n": 1,
"size": "1:1",
"quality": "high",
"response_format": "url",
"async": true
}多图编辑
请求端点：POST /v1/images/edits
{
"model": "gpt-image-2-1k",
"prompt": "参考 @Image1 中的建筑主体和 @Image2 中的配色，将两者融合为一张统一风格的临海建筑效果图。",
"images": [
"https://example.com/building.png",
"https://example.com/color-reference.png"
],
"n": 1,
"size": "1:1",
"quality": "high",
"response_format": "url",
"async": true
}- 在 images 数组中按顺序传入多张参考图片，最多支持 9 张；
- 在 prompt 中使用 @Image1、@Image2 等编号指代对应图片；
- @Image1 对应 images[0]，@Image2 对应 images[1]，后续以此类推；
蒙版编辑
请求端点：POST /v1/images/edits
{
"model": "gpt-image-2-1k",
"prompt": "将蒙版指定的编辑区域替换为一片花丛，与原图的光线和风格保持一致。",
"images": [
"https://example.com/reference.png"
],
"mask": "https://example.com/mask.png",
"n": 1,
"size": "1:1",
"quality": "high",
"response_format": "url",
"async": true
}- 通过 images 提供原始图片，通过 mask 提供蒙版图片，并在 prompt 中描述编辑要求；
- 以上示例中的图片和蒙版地址仅为占位，请替换为公网可访问的 HTTPS 图片链接；
结果获取
同步调用
请求会等待图片生成完成后返回结果。
使用 response_format: "url" 时，从成功响应中获取图片链接。
异步调用
提交成功后会返回任务 ID，此时图片可能尚未生成完成。
请使用该 ID 查询任务状态，待任务成功完成后获取图片链接。
文生图与图片编辑分别使用以下查询端点：
具体返回格式与查询方式，请参阅「图片同步接口」或「图片异步接口」。
图片链接不建议作为永久存储地址，最大有效期限为 24 小时，获取结果后请及时下载并保存。