## 生成图片
`POST /v1/images/generations`
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.ai/v1/images/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2.5-flare",
"prompt": "一张简洁的杂志风产品照片，半透明绿色玻璃瓶放在浅色石材上，柔和晨光",
"size": "1536x1024",
"quality": "high",
"background": "opaque",
"output_format": "jpeg",
"output_compression": 85,
"moderation": "auto",
"n": 1
}'
```
## 请求头
Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。
数据交换格式。
## 请求体
模型 ID：`gpt-image-2.5-sunburst` 或 `gpt-image-2.5-flare`。
描述目标图片的文本提示词。长度为 `1`–`32,000` 个字符。
生成图片数量，支持 `1`–`10`。
使用 `auto` 或自定义 `宽x高`。宽和高必须为 16 的倍数，宽高比在 1:3 到 3:1 之间，任一边不超过 3,840 像素，总像素数在 655,360 到 8,294,400 之间。
渲染质量：`low`、`medium`、`high`、`xhigh`、`max` 或 `auto`。
背景模式：`auto`、`opaque` 或 `transparent`。透明背景必须使用 PNG 或 WebP 输出。
输出格式：`png`、`jpeg` 或 `webp`。
JPEG 或 WebP 压缩等级，范围为 `0`–`100`。PNG 输出会忽略此参数。
内容审核严格程度：`auto` 或 `low`。
## 生成响应
```json 200 theme={null}
{
"created": 1788926400,
"background": "opaque",
"data": [
{
"b64_json": "iVBORw0KGgoAAA..."
}
],
"output_format": "jpeg",
"quality": "high",
"size": "1536x1024"
}
```
创建时间，Unix 秒级时间戳。
最终背景模式：`opaque` 或 `transparent`。
生成图片结果。
Base64 编码的图片数据。
返回图片格式：`png`、`jpeg` 或 `webp`。
结果使用的质量等级。
最终输出尺寸，格式为 `宽x高`。
## 编辑图片
`POST /v1/images/edits`
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.ai/v1/images/edits \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'model=gpt-image-2.5-sunburst' \
--form 'image[]=@/path/to/product.png' \
--form 'mask=@/path/to/mask.png' \
--form 'prompt=保持产品主体不变，将背景替换为暖色摄影棚渐变' \
--form 'size=1536x1024' \
--form 'quality=xhigh' \
--form 'background=opaque' \
--form 'output_format=png' \
--form 'n=1'
```
## 请求头
Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。
使用 multipart 表单上传时由客户端自动设置。
## 请求体
模型 ID：`gpt-image-2.5-sunburst` 或 `gpt-image-2.5-flare`。
一张源图片文件。上传多张图片时改用 `image[]`。每张源图片必须小于 50 MB。
最多 16 张源图片文件。不要同时传入 `image` 和 `image[]`。
可选编辑蒙版。蒙版用于引导编辑，不保证形成像素级精确边界。蒙版必须包含 Alpha 通道，与第一张源图片的格式和尺寸一致，且小于 50 MB。上传多张源图片时，蒙版作用于第一张图片。
描述编辑目标的文本指令。长度为 `1`–`32,000` 个字符。
返回编辑图片数量，支持 `1`–`10`。
使用 `auto` 或符合图片生成端点相同限制的自定义 `宽x高`。
渲染质量：`low`、`medium`、`high`、`xhigh`、`max` 或 `auto`。
背景模式：`auto`、`opaque` 或 `transparent`。透明背景必须使用 PNG 或 WebP 输出。
输出格式：`png`、`jpeg` 或 `webp`。
JPEG 或 WebP 压缩等级，范围为 `0`–`100`。PNG 输出会忽略此参数。
内容审核严格程度：`auto` 或 `low`。
## 编辑响应
```json 200 theme={null}
{
"created": 1788926460,
"background": "opaque",
"data": [
{
"b64_json": "iVBORw0KGgoAAA..."
}
],
"output_format": "png",
"quality": "xhigh",
"size": "1536x1024"
}
```
创建时间，Unix 秒级时间戳。
最终背景模式：`opaque` 或 `transparent`。
编辑图片结果。
Base64 编码的编辑后图片数据。
返回图片格式：`png`、`jpeg` 或 `webp`。
结果使用的质量等级。
最终输出尺寸，格式为 `宽x高`。