Skip to main content
POST
cURL
根据一个或多个源图像和提示创建编辑或扩展后的图像。该接口与 OpenAI 官方 Images API 的 POST /v1/images/edits 请求和响应结构保持一致。文档翻译自 官方文档。”, 支持模型包括 gpt-image-2gpt-image-1.5gpt-image-1dall-e-2
由于 OpenAI 图像编辑是同步响应,生成时间较长,建议使用 https://api.ttapi.org 网关

授权

TT-API-KEY
string
header
必填

请前往 TTAPI 控制台 获取 API 密钥。

请求体

application/json
images
object[]
必填

要编辑的输入图片引用。GPT Image 模型最多可提供 16 张图片。每个对象需提供 file_idimage_url

prompt
string
必填

描述目标编辑结果的文本提示。GPT Image 模型最多支持 32000 个字符;dall-e-2 最多支持 1000 个字符。

model
enum<string>
必填

用于图像编辑的模型。

可用选项:
gpt-image-2,
gpt-image-1.5,
gpt-image-1
mask
object

可选蒙版图片引用。需且仅需提供 file_idimage_url 之一。

background
enum<string>
默认值:auto

设置输出图像背景的透明度。仅适用于 GPT Image 模型。可选 transparentopaqueauto(默认)。透明背景需要 pngwebp 输出格式。

可用选项:
transparent,
opaque,
auto
input_fidelity
enum<string>
默认值:low

控制输入图像细节保留程度。可选 highlow,默认值为 low。仅适用于 GPT Image 模型。

可用选项:
high,
low
moderation
enum<string>
默认值:auto

GPT Image 模型的审核级别。可选 lowauto

可用选项:
low,
auto
n
integer

要生成的图像数量,默认值为 1。可选范围 1-10

output_compression
integer
默认值:100

生成图像的压缩级别(0-100)。仅适用于 output_formatwebpjpeg 的 GPT Image 模型,默认值为 100。

output_format
enum<string>
默认值:png

生成图像的返回格式。仅适用于 GPT Image 模型。可选 png(默认)、jpegwebp

可用选项:
png,
jpeg,
webp
partial_images
integer
默认值:0

流式响应中要返回的部分图片数量,范围 0-3,默认值为 0。仅当 streamtrue 时可用。

quality
string
默认值:auto

图像质量。auto(默认)会为给定模型自动选择最佳质量。

GPT Image 模型支持 highmediumlow

dall-e-2 仅支持 standard

response_format
enum<string>

返回数据格式。仅 dall-e-2 支持 urlb64_json;URL 有效期为 60 分钟。GPT Image 模型始终返回 b64_json

可用选项:
url,
b64_json
size
string
默认值:auto

图像尺寸。

GPT Image 模型支持 1024x10241536x10241024x1536auto(默认);

dall-e-2 支持 256x256512x5121024x1024

stream
boolean
默认值:false

是否以流式方式返回编辑进度。启用后可通过 partial_images 获取部分图片事件。

user
string

代表最终用户的唯一标识,可帮助 OpenAI 监测和检测滥用。

响应

请求成功,返回Base64格式图像生成结果(当前仅支持该格式)

created
integer
必填

生成时间戳(秒)

示例:

1713833628

data
object[]
必填

图像生成结果列表

usage
object
必填

Token使用量(Base64格式必返回)

示例:
最后修改于 2026年6月16日