images.generate(OpenAI 兼容)
与 POST https://api.openai.com/v1/images/generations 完全对齐;同步返回图片结果。
扩展行为(官方 SDK 不会触发):当 JSON body 携带非空 image(URL / data URL / 纯 base64,单张或数组)时,自动改走图编辑(image_edit)流程,依然同步返回。
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
提示词(prompt)
模型
gpt-image-2 尺寸 / 分辨率。可传 ImageResolution 枚举值,或自定义 WxH(如 1280x960)。自定义尺寸须满足以下约束:① 单边 ≤ 3840 px;② 宽、高均为 16 的倍数;③ 长边 : 短边 ≤ 3:1;④ 总像素 ∈ [655 360, 8 294 400]。不满足约束或渠道不支持自定义尺寸时请求将被拒绝。
auto, 1024x1024, 1536x1024, 1024x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840 生成数量(当前仅支持 1)
1 <= x <= 1质量等级
auto, low, medium, high, standard 背景透明度
transparent, opaque, auto 输出文件格式
png, jpeg, webp JPEG / WebP 的压缩等级 0-100
0 <= x <= 100审核强度
auto, low 响应格式:url 返回图片自家 S3 URL;b64_json 返回 base64。本服务对所有渠道(含 OpenAI gpt-image-* 这种上游强制返 b64 的模型)都会按本字段严格输出,不会两个字段都返回。不传时按 url 处理。
url, b64_json 输入图保真度(gpt-image-2 新增,仅 edit 场景生效;generate 可忽略)
high, low 终端用户标识(透传给上游供滥用监控)
【本服务私有扩展,官方 SDK 不会传】输入图片(URL / data URL / 纯 base64)。提供则同步触发图编辑(image_edit),不提供则保持原文生图行为。支持单张字符串或字符串数组。
【本服务私有扩展,官方 SDK 不会传】mask 图片(URL / data URL / 纯 base64);仅在同时提供 image 时生效,透明区域将被重绘。