跳转到主要内容
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 '
{
  "prompt": "<string>",
  "image": "<array>",
  "mask": "<unknown>",
  "mode": "dall-e-2",
  "n": 123,
  "output_compression": "100",
  "quality": "auto",
  "response_format": "<string>",
  "size": "auto"
}
'
{
  "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
    }
  }
}

​
OpenAI Image Models

根据给定的一个或多个源图像和提示，编辑或扩展图像。支持模型 gpt-image-1,dall-e-2

授权

​
TT-API-KEY
string
header
必填

授权字段，控制台获取授权信息

请求体

application/json
​
prompt
string
必填

图像的文本描述。gpt-image-1 的最大长度为 32000 个字符，dall-e-2 的最大长度为 1000 个字符，dall-e-3 的最大长度为 4000 个字符。

​
image
array
必填

要编辑的图片。。必须是受支持的图片文件或图片数组。
gpt-image-1，每张图片应为小于 25MB 的 png、webp 或 jpg 文件。
dall-e-2，您只能提供一张图片，并且该图片应为小于 4MB 的方形 png 文件。

​
mask
file

一张附加图片，其完全透明区域（例如，Alpha 值为零）指示应编辑图片的位置如果提供了多张图片，则蒙版将应用于第一张图片。必须是有效的 PNG 文件，大小小于 4MB，且尺寸与图片相同。

​
mode
enum<string>
默认值:dall-e-2

支持模型

可用选项:
gpt-image-1,
dall-e-2
​
n
integer

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

​
output_compression
integer
默认值:100

生成图像的压缩级别(0-100%)。此参数仅支持输出格式为 webp 或 jpeg 的 gpt-image-1，默认为 100。

​
quality
string
默认值:auto

图片质量。可选范围：
auto（默认值）将自动为给定模型选择最佳质量。
gpt-image-1 支持high、medium、low三种质量。
dall-e-3 支持 hd 和 standard。
dall-e-2 仅支持 standard。

​
response_format
string

返回数据格式。
dall-e-3, dall-e-2 支持 url或 b64_json，url有效期为60分钟，请获取到数据后第一时间缓存。
gpt-image-1 仅支持 b64_json

​
size
string
默认值:auto

图像尺寸。
gpt-image-1 可选范围1024x1024,1536x1024,1024x1536,auto（默认）
dall-e-2 可选范围256x256,512x512,1024x1024
dall-e-3 可选范围1024x1024,1792x1024,1024x1792
注意：不同尺寸消耗ttapi quota不同

响应

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

​
created
integer
必填

生成时间戳（秒）

示例:

1713833628

​
data
object[]
必填

图像生成结果列表

​
usage
object
必填

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

示例:
{
  "input_tokens": 50,
  "input_tokens_details": { "image_tokens": 40, "text_tokens": 10 },
  "output_tokens": 50,
  "total_tokens": 100
}
Last modified on March 12, 2026