GPT Image 图片

OpenAI Images API。文生图使用 JSON，图生图与编辑使用 multipart 上传参考图，结果同步返回。

可用模型

GPT-image-2.5 GPT-image-2 GPT-image-2.5-flare GPT-image-2.5-sunburst GPT-image-2-official原生全参数 GPT-image-2.5-flare-official原生全参数 GPT-image-2.5-sunburst-official原生全参数

选择模型，下方示例和参数会切换为该模型。

GPT-image-2-official

Images API · POST /v1/images/generations

请求示例

curl -X POST 'https://code.exgravity.ai/v1/images/generations' \
  -H "Authorization: Bearer $UIKA_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "model": "GPT-image-2-official",
  "prompt": "一只橘猫坐在窗边，柔和的午后阳光，电影质感",
  "n": 1,
  "size": "1024x1024",
  "quality": "auto"
}'

请求参数

字段	说明
`model`	完整模型 ID，保留大小写、空格和后缀。
`prompt`	图片内容描述。
`n`	示例生成 1 张图片。
`size`	传像素尺寸，如 1K：1536x864（16:9）；2K：2048x1152（16:9）；4K：3840x2160（16:9）。1:1 的 4K 档为 2880x2880。
`quality`	auto / low / medium / high

参考素材

参考图使用 multipart/form-data；image[] 为本地图片文件，可重复传入多张。不要手动设置 multipart 的 Content-Type。

带参考素材的请求

curl -X POST 'https://code.exgravity.ai/v1/images/edits' \
  -H "Authorization: Bearer $UIKA_API_KEY" \
  -F 'model=GPT-image-2-official' \
  -F 'prompt=一只橘猫坐在窗边，柔和的午后阳光，电影质感' \
  -F 'n=1' \
  -F 'size=1024x1024' \
  -F 'quality=auto' \
  -F 'image[]=@./reference.png'

返回结果

同步返回 data 数组，读取 data[].b64_json 解码图片，或读取 data[].url（以实际响应字段为准）。

注意事项