跳转到主要内容
POST
图片编辑

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
images
object[]
必填

必填。待编辑的源图列表。GPT Image 模型最多 16 张;每项需提供 file_id 或 image_url 之一。若直接上传文件,使用 multipart 字段 image[](或你的网关定义的 images)。

Required array length: 1 - 16 elements
prompt
string
必填

必填。期望如何编辑或扩展图像的文字描述。

Minimum string length: 1
model
string
必填

必填。使用 Get Models 返回的模型 ID 或可用别名。

Minimum string length: 1
示例:

"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"

"gpt-image-2-2026-04-21"

"gpt-image-1.5"

"gpt-image-1"

"gpt-image-1-mini"

"chatgpt-image-latest"

"dall-e-2"

background
enum<string> | null

输出背景,仅 GPT Image 模型支持。transparent 时 output_format 必须为 png 或 webp。

可用选项:
transparent,
opaque,
auto,
null
input_fidelity
enum<string> | null

与原始输入图像保持一致的程度,仅受支持的 GPT Image 模型适用。

可用选项:
high,
low,
null
mask
object

用于局部重绘的遮罩。file_id 与 image_url 二选一。

moderation
enum<string> | null

内容审核级别,仅 GPT Image 模型支持。

可用选项:
low,
auto,
null
n
integer | null

要生成的编辑后图像数量。

必填范围: 1 <= x <= 10
output_compression
integer | null

jpeg 或 webp 输出的压缩率(0–100),仅 GPT Image 模型支持。

必填范围: 0 <= x <= 100
output_format
enum<string> | null

输出图片格式,仅 GPT Image 模型支持。

可用选项:
png,
jpeg,
webp,
null
partial_images
integer | null

流式响应中生成的中间图数量。

必填范围: 0 <= x <= 3
quality
enum<string> | null

输出质量。GPT Image 支持 low/medium/high/auto;GPT Image 2.5 额外支持 xhigh/max。

可用选项:
low,
medium,
high,
xhigh,
max,
auto,
null
size
string

输出尺寸,使用 auto 或 WIDTHxHEIGHT;具体尺寸范围和约束见所选模型能力。

Pattern: ^(auto|[1-9][0-9]*x[1-9][0-9]*)$
stream
boolean | null

是否以 SSE 事件流返回中间和最终结果。

user
string

终端用户唯一标识,用于滥用监控和检测。

response_format
enum<string>
默认值:url

Tikway 图片交付格式,url 返回图片链接,b64_json 返回纯 Base64。默认 url;该字段由网关消费,不作为上游模型参数。

可用选项:
b64_json,
url

响应

200 - application/json
created
integer
必填

编辑结果创建时的 Unix 时间戳(秒)。

data
object[]
必填

编辑后的图像列表。

background
enum<string>

实际采用的输出背景。

可用选项:
transparent,
opaque
output_format
enum<string>

实际输出格式。

可用选项:
png,
webp,
jpeg
quality
enum<string>

实际使用的输出质量。

可用选项:
low,
medium,
high,
auto
size
string

实际生成的图片尺寸。

usage
object

GPT Image 模型的 token 用量。