## 创建图片
`POST /v1/images/generations`
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.com.cn/v1/images/generations \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedream-5-0-pro-260628",
"prompt": "一只白色陶瓷杯放在浅灰色背景上，居中构图，柔和阴影，产品摄影，无文字",
"size": "1.5K",
"response_format": "url",
"output_format": "jpeg",
"watermark": false,
"optimize_prompt_options": { "mode": "fast" }
}'
```
固定为 `doubao-seedream-5-0-pro-260628`。
图片生成提示词。中文建议不超过 300 字，英文建议不超过 600 词。
`1K`、`1.5K`、`2K` 或合法的 `宽x高`。自定义尺寸总像素数须在 921,600–4,624,220，宽高比须在 `[1/16, 16]`。
`url` 或 `b64_json`。URL 有效期为 24 小时。
`jpeg` 或 `png`。
是否添加“AI 生成”水印。
提示词优化配置。
`standard` 或 `fast`，两种模式均支持。
### 创建响应
```json 200 theme={null}
{
"model": "doubao-seedream-5-0-pro-260628",
"created": 1787562068,
"data": [{
"url": "https://example.com/generated-image.jpeg",
"size": "1536x1536",
"output_format": "jpeg"
}],
"usage": {
"input_images": 0,
"generated_images": 1,
"output_tokens": 9216,
"total_tokens": 9216
}
}
```
## 编辑或融合图片
`POST /v1/images/generations`
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.com.cn/v1/images/generations \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedream-5-0-pro-260628",
"prompt": "使用图 1 的构图，并采用图 2 的视觉风格。",
"image": [
"https://example.com/composition.png",
"https://example.com/style.png"
],
"size": "1K",
"response_format": "url",
"output_format": "jpeg",
"watermark": false
}'
```
固定为 `doubao-seedream-5-0-pro-260628`。
编辑或参考生成指令。坐标编辑可使用归一化 `` 和 `` 标签。
图片 URL、Base64 Data URI，或最多 10 张参考图组成的数组。
`1K`、`1.5K`、`2K` 或合法的自定义像素尺寸。
`url` 或 `b64_json`。
`jpeg` 或 `png`。
是否添加“AI 生成”水印。
`standard` 或 `fast`。
### 创建响应
```json 200 theme={null}
{
"model": "doubao-seedream-5-0-pro-260628",
"created": 1787562132,
"data": [{
"url": "https://example.com/fused-image.jpeg",
"size": "1024x1024",
"output_format": "jpeg"
}],
"usage": {
"input_images": 2,
"generated_images": 1,
"output_tokens": 4096,
"total_tokens": 4096
}
}
```
普通参考图支持 jpeg、png、webp、bmp、tiff、gif、heic 和 heif。单张图片小于 30 MB，宽高比在 `[1/16, 16]`，宽和高均大于 14 px，总像素数不超过 36,000,000。
## 保留透明通道
`POST /v1/images/generations`
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.com.cn/v1/images/generations \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedream-5-0-pro-260628",
"prompt": "保留主体并优化边缘，同时保持透明背景。",
"image": "https://example.com/transparent-source.png",
"background": "transparent",
"size": "1K",
"response_format": "url",
"output_format": "png",
"watermark": false
}'
```
固定为 `doubao-seedream-5-0-pro-260628`。
图片编辑指令。
仅允许 1 张带 Alpha 通道的输入图。PNG 支持透明通道，JPEG 不支持。
`transparent` 表示保留透明背景，`opaque` 表示生成普通不透明背景。
`1K`、`1.5K`、`2K` 或合法的自定义像素尺寸。
`background` 为 `transparent` 时必须使用 `png`。
`url` 或 `b64_json`。
是否添加“AI 生成”水印。
### 创建响应
```json 200 theme={null}
{
"model": "doubao-seedream-5-0-pro-260628",
"created": 1787562204,
"data": [{
"url": "https://example.com/transparent-result.png",
"size": "1024x1024",
"output_format": "png"
}],
"usage": {
"input_images": 1,
"generated_images": 1,
"output_tokens": 4096,
"total_tokens": 4096
}
}
```
## 拆分图片图层
`POST /v1/images/generations`
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.com.cn/v1/images/generations \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedream-5-0-pro-260628",
"prompt": "仅将鹦鹉主体与背景分离为一个可编辑图层。",
"image": "https://example.com/parrot-poster.png",
"layer_decomposition": true,
"size": "2K",
"response_format": "url",
"output_format": "jpeg",
"watermark": false
}'
```
固定为 `doubao-seedream-5-0-pro-260628`。
可选的拆层指令，可使用归一化 `` 坐标指定元素。
仅允许 1 张 PNG 或 JPEG。
设为 `true`，返回 1 张底图和最多 16 个可编辑图层。
`auto`、`1K`、`1.5K` 或 `2K`；该模式不支持自定义像素尺寸。
`url` 或 `b64_json`。
仅控制底图格式；拆出的图层始终为 PNG。
是否添加“AI 生成”水印。
### 创建响应
```json 200 theme={null}
{
"model": "doubao-seedream-5-0-pro-260628",
"created": 1787562257,
"data": [
{
"url": "https://example.com/background.jpeg",
"size": "2048x2048",
"output_format": "jpeg",
"z_index": 0
},
{
"url": "https://example.com/parrot-layer.png",
"size": "892x2179",
"output_format": "png",
"z_index": 1,
"bounding_box": {
"absolute": [730, 627, 1301, 2021],
"normalized": [356, 306, 635, 986]
},
"name": "鹦鹉主体",
"description": "从原图中拆出的透明背景鹦鹉主体"
}
],
"usage": {
"input_images": 1,
"generated_images": 2,
"output_tokens": 33768,
"total_tokens": 33768
}
}
```
拆层输入图总像素数须在 512 × 512 到 6000 × 6000 之间，宽高比须在 `[1/16, 16]`，文件小于 30 MB。任一目标图层失败时，整个请求失败。
## 请求头