Skip to main content
POST
/
v1
/
images
/
edits
cURL
curl --request POST \
  --url https://api.ttapi.io/v1/images/edits \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "images": [
    {
      "file_id": "<string>",
      "image_url": "<string>"
    }
  ],
  "prompt": "<string>",
  "mask": {
    "file_id": "<string>",
    "image_url": "<string>"
  },
  "background": "auto",
  "input_fidelity": "low",
  "moderation": "auto",
  "n": 123,
  "output_compression": 100,
  "output_format": "png",
  "partial_images": 0,
  "quality": "auto",
  "size": "auto",
  "stream": false,
  "user": "<string>"
}
'
{
  "created": 1713833628,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABhWlDQ1BJQ0MgcHJvZmlsZQAAKJF9kT1Iw0AcxV9TpSItDnaQIpKhOlkQVFIwU8CR1NZBLi4iFg8B4R33PTK77Z22p22e+628923923f/jH53eV73923/..."
    }
  ],
  "usage": {
    "total_tokens": 100,
    "input_tokens": 50,
    "output_tokens": 50,
    "input_tokens_details": {
      "text_tokens": 10,
      "image_tokens": 40
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ttapi.io/llms.txt

Use this file to discover all available pages before exploring further.

根据一个或多个源图像和提示创建编辑或扩展后的图像。该接口与 OpenAI 官方 Images API 的 POST /v1/images/edits 请求和响应结构保持一致。文档翻译自 官方文档。”, 支持模型包括 gpt-image-2、gpt-image-1.5、gpt-image-1 和 dall-e-2。

Authorizations

​
TT-API-KEY
string
header
required

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

Body

application/json
​
images
object[]
required

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

​
prompt
string
required

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

​
model
enum<string>
required

用于图像编辑的模型。

Available options:
gpt-image-2,
gpt-image-1.5,
gpt-image-1
​
mask
object

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

​
background
enum<string>
default:auto

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

Available options:
transparent,
opaque,
auto
​
input_fidelity
enum<string>
default:low

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

Available options:
high,
low
​
moderation
enum<string>
default:auto

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

Available options:
low,
auto
​
n
integer

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

​
output_compression
integer
default:100

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

​
output_format
enum<string>
default:png

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

Available options:
png,
jpeg,
webp
​
partial_images
integer
default:0

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

​
quality
string
default: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。

Available options:
url,
b64_json
​
size
string
default:auto

图像尺寸。

GPT Image 模型支持 1024x1024、1536x1024、1024x1536、auto（默认）；

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

​
stream
boolean
default:false

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

​
user
string

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

Response

请求成功，返回Base64格式图像生成结果（当前仅支持该格式）

​
created
integer
required

生成时间戳（秒）

Example:

1713833628

​
data
object[]
required

图像生成结果列表

​
usage
object
required

Token使用量（Base64格式必返回）

Example:
{
  "input_tokens": 50,
  "input_tokens_details": { "image_tokens": 40, "text_tokens": 10 },
  "output_tokens": 50,
  "total_tokens": 100
}
Last modified on May 20, 2026