生成图像
OpenAI Images API 兼容的图像生成接口。默认同步返回图片结果;如需异步提交,在请求 URL 上携带 ?async=true,接口会返回图片任务 ID,可通过 /v1/tasks/{id} 查询结果。
GPT Image 2.5 / 2.6 使用专用 GPT Image 请求定义。
Seedream 5.5 使用 dola-seedream-5-5-261028,在本路径以 JSON 调用文生图、参考图编辑或图层拆分。
GPT Image 2.6 支持 complexity、动画 GIF 和 SVG;SVG 仅用于此生成接口。
支持流式的 GPT Image 模型可用 stream=true 返回 image_generation.partial_image 和 image_generation.completed SSE 事件。Seedream 5.5 使用非流式响应。
官方文档见 OpenAI 图片生成 和 BytePlus 图片生成 API。
bearerAuthAuthorizationBearer <API key>使用 Authorization Bearer API Key 进行鉴权。
async?boolean是否异步提交。
falseapplication/json- body
GPT Image 2.6 支持 PNG、JPEG、WebP、GIF 和 SVG;2.5 使用 PNG、JPEG、WebP。 GIF 不支持 streaming、partial_images、mask、output_compression 或 prompt_rewriter。 SVG 仅用于 generations,n=1,不支持 streaming、partial_images、output_compression 或 prompt_rewriter。
model*string"gpt-image-2.5-sunburst""gpt-image-2.5-sunburst-2026-09-08""gpt-image-2.5-flare""gpt-image-2.5-flare-2026-09-08""gpt-image-2.6-sunburst""gpt-image-2.6-flare"prompt*string描述生成内容或编辑要求;GIF 提示词应说明动作和循环方式。
1 <= length <= 32000n?|输出图片数量;GPT Image 2.6 的 GIF 按动画数量计,SVG 必须为 1。
1 <= value <= 101size?|auto 或 WIDTHxHEIGHT,例如 1024x1024、1536x1024、1024x1536、1536x864。 自定义静态尺寸的宽高为 16 的倍数,宽高比介于 1:3 与 3:1。 GPT Image 2.5 的单边不超过 3840,总像素为 655360–8294400;超过 2560x1440 的分辨率属于实验支持。 GPT Image 2.6 还须满足所选模型当前的像素总量和边长限制,不沿用 2.5 的数值上限。 GPT Image 2.6 GIF 的 size 是每帧尺寸:宽高为正数且为 16 的倍数,并与 frame_count、n 一起满足模型的动画像素预算; 不套用静态图片的总像素下限,可使用 auto 自动选取。
^(auto|[1-9][0-9]*x[1-9][0-9]*)$"auto"quality?|GPT Image 2.5 / 2.6 的渲染质量;2.6 输出 SVG 时控制用于矢量化的参考图质量。
"auto""auto""low""medium""high""xhigh""max"nullcomplexity?|GPT Image 2.6 的图像规划计算量,与 quality 独立;SVG 时控制参考图,不控制 SVG 作者的 reasoning。
"high""low""medium""high"nullbackground?|背景模式。透明位图使用 png 或 webp 输出;GPT Image 2.6 的 SVG 也支持 transparent。
"auto""auto""opaque""transparent"nulloutput_compression?|JPEG / WebP 输出压缩参数;GPT Image 2.6 的 GIF 和 SVG 不支持自定义压缩。
0 <= value <= 100100frame_count?|GPT Image 2.6 GIF 的帧数,仅用于 output_format=gif。
2 <= value <= 169frame_duration_ms?|GPT Image 2.6 GIF 每帧时长,单位毫秒;编码时舍入到最接近的 10 ms,仅用于 output_format=gif。
20 <= value <= 2000200stream?|启用 SSE 返回预览和最终图像;GPT Image 2.6 的 GIF / SVG 不支持流式输出。
falsepartial_images?|流式输出中最多返回的中间预览图数量。0 表示只返回最终图;最终图提前完成时,实际预览数量可能更少。 GPT Image 2.6 的 GIF / SVG 不支持中间预览图。以最终事件的 usage 读取用量。
0 <= value <= 30safety_identifier?|稳定的终端用户安全标识,建议使用哈希。非空值优先于 user;省略、null 或空字符串时回退到 user。
length <= 128user?stringDeprecated已废弃的终端用户标识;仅在 safety_identifier 省略、null 或为空时作为回退值。
output_format?|输出文件编码;GIF 和 SVG 为 GPT Image 2.6 的输出能力。
"png""png""jpeg""webp""gif""svg"nullmoderation?|图像内容审核级别。
"auto""auto""low"nullsvg?|null成功响应。
- response
created*integerUnix 秒级时间戳。
data?array<>background?string"opaque""transparent"output_format?string"png""jpeg""webp""gif""svg"quality?string"low""medium""high""xhigh""max"size?string实际输出尺寸 WIDTHxHEIGHT;GIF 表示每帧尺寸。
safety_identifier?|生效的标识符;优先为请求中的非空 safety_identifier,否则为 user 回退值。
usage?图像模型的实际 token 用量;SVG 作者用量单独位于 svg_usage,不合并进此对象。
svg_usage?编写 SVG 的作者模型用量,与图像渲染 usage 分开统计。
curl -X POST 'https://goldflow.cc/v1/images/generations?async=true' \ -H 'Content-Type: application/json' \ -d '{ "model": "gpt-image-2.5-flare", "prompt": "一张未来感 API 网关控制台截图", "size": "1024x1024"}'{ "created": 0, "data": [ { "b64_json": "string" } ], "background": "opaque", "output_format": "png", "quality": "low", "size": "string", "safety_identifier": "string", "usage": { "input_tokens": 0, "input_tokens_details": { "image_tokens": 0, "text_tokens": 0 }, "output_tokens": 0, "output_tokens_details": { "image_tokens": 0, "text_tokens": 0 }, "total_tokens": 0 }, "svg_usage": { "model": "string", "input_tokens": 0, "output_tokens": 0, "reasoning_tokens": 0, "total_tokens": 0 }}GPT Image 2.6 Integration Guide
Previous Page
Image Editing
OpenAI Images API 兼容的图像编辑接口。默认同步返回编辑后的图片结果;如需异步提交,在请求 URL 上携带 `?async=true`,接口会返回图片任务 ID,可通过 `/v1/tasks/{id}` 查询结果。 GPT Image 2.5 / 2.6 支持 JSON `images` 引用数组,或 multipart `image` / `image[]` 文件上传;输入图片支持 PNG、JPEG、WebP,最多 16 张。 `markup` 是单独上传的透明 PNG 标注层,与 `mask` 互斥。GPT Image 2.6 可输出 GIF;编辑接口不支持 SVG 输出或 SVG 输入。 `stream=true` 时返回 `image_edit.partial_image` 和 `image_edit.completed` SSE 事件;GIF 不支持流式输出。 官方参数说明:https://developers.openai.com/api/reference/resources/images/methods/edit 。