POST
根据提示词生成图片,支持 URL 和 Base64 返回方式。API Key 需绑定具有图片权限的分组;异步调用见图片任务。

模型选择

请求参数

string
required
当前 Key 可用的 GPT Image 模型 ID。
string
required
生成提示词。建议写明主体、材质、背景、构图和文字要求。
integer
default:"1"
生成数量,必须为大于 0 的整数,默认 1。数量上限见模型说明。
string
输出像素尺寸,格式为 宽x高,例如 1024x1024、1536x1024、1024x1536。
string
返回格式:url 为图片地址,b64_json 为 Base64 图片数据。
string
图片质量,省略时使用模型默认值。可选值见对应模型说明。
string
背景控制,仅在支持该选项的模型上使用。
string
图片文件格式,适用于支持格式选择的模型;response_format 用于选择 URL 或 Base64 返回方式。
integer
图片压缩程度,适用于支持压缩的模型和输出格式。

尺寸与参考图

其他尺寸和清晰度档位见对应模型说明。模型名称带清晰度后缀时,使用匹配的尺寸。

返回结果

结果 URL 请及时下载保存。需要参考图时使用图片编辑接口。