Skip to main content
POST
/
v1
/
images
/
edits
编辑图像
curl --request POST \
  --url https://api.amux.ai/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form image='@example-file' \
  --form 'prompt=<string>' \
  --form 'image[]=<string>' \
  --form mask='@example-file' \
  --form model=gpt-image-2-official \
  --form n=1 \
  --form size=auto \
  --form quality=auto \
  --form background=auto \
  --form output_format=png \
  --form output_compression=100 \
  --form moderation=auto \
  --form 'user=<string>' \
  --form image[].items='@example-file'
{
  "created": 1713833628,
  "background": "opaque",
  "data": [
    {
      "b64_json": "<base64-png>"
    }
  ],
  "output_format": "png",
  "quality": "auto",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 12,
    "input_tokens_details": {
      "image_tokens": 1,
      "text_tokens": 11
    },
    "output_tokens": 4096,
    "total_tokens": 4108,
    "output_tokens_details": {
      "image_tokens": 4096,
      "text_tokens": 0
    }
  }
}

Authorizations

Authorization
string
header
required

API Key 通过 Authorization: Bearer <key> 传入。

Body

multipart/form-data

multipart/form-data 请求体。

image
file
required

待编辑的输入图像(png/jpeg/webp)。多张输入请改用重复的 image[] 字段。

prompt
string
required

描述所需编辑的指令。

Maximum string length: 32000
image[]
file[]

多张输入图像(重复表单字段,最多 16 张)。

mask
file

可选 PNG 蒙版;完全透明(alpha=0)区域为待编辑区域。

model
enum<string>
default:gpt-image-2-official
Available options:
gpt-image-2-official
input_fidelity
enum<string>

对原始输入图像的保真程度。

Available options:
high,
low
n
integer
default:1

生成的编辑图数量。

Required range: 1 <= x <= 10
size
string
default:auto

输出尺寸(规则同生成接口)。

Examples:

"auto"

"1024x1024"

"1536x1024"

"1024x1536"

quality
enum<string>
default:auto
Available options:
low,
medium,
high,
auto
background
enum<string>
default:auto

背景处理。暂不支持透明背景。

Available options:
opaque,
auto
output_format
enum<string>
default:png

输出图像格式。

Available options:
png,
jpeg
output_compression
integer
default:100

jpeg 输出的压缩级别。

Required range: 0 <= x <= 100
moderation
enum<string>
default:auto
Available options:
low,
auto
user
string

用于滥用监测的终端用户标识。

Response

编辑后的图像。

created
integer
required

Unix 时间戳(秒)。

data
object[]
required
background
enum<string>
Available options:
opaque
output_format
enum<string>
Available options:
png,
jpeg
quality
enum<string>
Available options:
low,
medium,
high
size
string

实际渲染尺寸,如 1024x1024

usage
object