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

授权

TT-API-KEY
string
header
必填

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

请求体

application/json
images
object[]
必填

要编辑的输入图片引用。GPT Image 模型最多可提供 16 张图片。每个对象需提供 file_id 或 image_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_id 或 image_url 之一。

background
enum<string>
默认值:auto

设置输出图像背景的透明度。仅适用于 GPT Image 模型。可选 transparent、opaque 或 auto(默认)。透明背景需要 png 或 webp 输出格式。

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

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

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

GPT Image 模型的审核级别。可选 low 或 auto。

可用选项:
low,
auto
n
integer

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

output_compression
integer
默认值:100

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

output_format
enum<string>
默认值:png

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

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

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

quality
string
默认值:auto

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

GPT Image 模型支持 high、medium、low;

dall-e-2 仅支持 standard。

response_format
enum<string>

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

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

图像尺寸。

GPT Image 模型支持 1024x1024、1536x1024、1024x1536、auto(默认);

dall-e-2 支持 256x256、512x512、1024x1024。

stream
boolean
默认值:false

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

user
string

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

响应

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

created
integer
必填

生成时间戳(秒)

示例:

1713833628

data
object[]
必填

图像生成结果列表

usage
object
必填

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

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