图片生成

Header Parameters

Authorization*string

使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

Request Body

application/json

model*string

模型名称，固定值：

doubao-seedream-4-0-250828

doubao-seedream-4-5-251128

doubao-seedream-5-0-260128

prompt*string

用于生成图像的提示词，支持中英文。

建议不超过300个汉字或600个英文单词。字数过多信息容易分散，模型可能因此忽略细节，只关注重点，造成图片缺失部分元素。

size?string

指定生成图像的尺寸信息

Doubao-Seedream-5.0-lite：

方式 1 | 指定生成图像的分辨率，并在prompt中用自然语言描述图片宽高比、图片形状或图片用途，最终由模型判断生成图片的大小。

可选值：2K、3K、4K

方式 2 | 指定生成图像的宽高像素值：

默认值：2048x2048

总像素取值范围：[2560x1440=3686400, 4096x4096=16777216]

宽高比取值范围：[1/16, 16]

说明：

图宽度和高度的像素乘积限制，而不是对宽度或高度的单独值进行限制。

有效示例：3750x1250

总像素值 3750x1250=4687500，符合 [3686400, 16777216] 的区间要求；宽高比 3750/1250=3，符合 [1/16, 16] 的区间要求，故该示例值有效。

无效示例：1500x1500

总像素值 1500x1500=2250000，未达到 3686400 的最低要求；宽高 1500/1500=1，虽符合 [1/16, 16] 的区间要求，但因其未同时满足两项限制，故该示例值无效。

推荐的宽高像素值：

2K分辨率下，宽高比/宽高像素值：

1:1->2048x2048

4:3->2304x1728

3:4->1728x2304

16:9->2848x1600

9:16->1600x2848

3:2->2496x1664

2:3->1664x2496

21:9->3136x1344

3K分辨率下，宽高比/宽高像素值：

1:1->3072x3072

4:3->3456x2592

3:4->2592x3456

16:9->4096x2304

9:16->2304x4096

2:3->2496x3744

3:2->3744x2496

21:9->4704x2016

4K分辨率下，宽高比/宽高像素值：

1:1->4096x4096

3:4->3520x4704

4:3->4704x3520

16:9->5504x3040

9:16->3040x5504

2:3 ->3328x4992

3:2 ->4992x3328

21:9->6240x2656

Doubao-Seedream 4.5：

方式 1 | 指定生成图像的分辨率，并在prompt中用自然语言描述图片宽高比、图片形状或图片用途，最终由模型判断生成图片的大小。

可选值：2K、4K

方式 2 | 指定生成图像的宽高像素值：

默认值：2048x2048

总像素取值范围：[2560x1440=3686400, 4096x4096=16777216]

宽高比取值范围：[1/16, 16]

说明：

图宽度和高度的像素乘积限制，而不是对宽度或高度的单独值进行限制。

有效示例：3750x1250

总像素值 3750x1250=4687500，符合 [3686400, 16777216] 的区间要求；宽高比 3750/1250=3，符合 [1/16, 16] 的区间要求，故该示例值有效。

无效示例：1500x1500

总像素值 1500x1500=2250000，未达到 3686400 的最低要求；宽高 1500/1500=1，虽符合 [1/16, 16] 的区间要求，但因其未同时满足两项限制，故该示例值无效。

推荐的宽高像素值：

2K分辨率下，宽高比/宽高像素值：

1:1->2048x2048

4:3->2304x1728

3:4->1728x2304

16:9->2848x1600

9:16->1600x2848

3:2->2496x1664

2:3->1664x2496

21:9->3136x1344

4K分辨率下，宽高比/宽高像素值：

1:1->4096x4096

3:4->3520x4704

4:3->4704x3520

16:9->5504x3040

9:16->3040x5504

2:3 ->3328x4992

3:2 ->4992x3328

21:9->6240x2656

Doubao-Seedream 4.0：

方式 1 | 指定生成图像的分辨率，并在prompt中用自然语言描述图片宽高比、图片形状或图片用途，最终由模型判断生成图片的大小。

可选值：1K、2K、4K

方式 2 | 指定生成图像的宽高像素值：

默认值：2048x2048

总像素取值范围：[1280x720=921600, 4096x4096=16777216]

宽高比取值范围：[1/16, 16]

说明:

采用方式 2 时，需同时满足总像素取值范围和宽高比取值范围。其中，总像素是对单张图宽度和高度的像素乘积限制，而不是对宽度或高度的单独值进行限制。

有效示例：1600x600

总像素值 1600x600=960000，符合 [921600, 16777216] 的区间要求；宽高比 1600/600=8/3，符合 [1/16, 16] 的区间要求，故该示例值有效。

无效示例：800x800

总像素值 800x800=640000，未达到 921600 的最低要求；宽高 800/800=1，虽符合 [1/16, 16] 的区间要求，但因其未同时满足两项限制，故该示例值无效。

推荐的宽高像素值：

1K分辨率下，宽高比/宽高像素值

1:1->1024x1024

4:3->1152x864

3:4->864x1152

16:9->1280x720

9:16->720x1280

3:2->1248x832

2:3->832x1248

21:9->1512x648

2K分辨率下，宽高比/宽高像素值：

1:1->2048x2048

4:3->2304x1728

3:4->1728x2304

16:9->2848x1600

9:16->1600x2848

3:2->2496x1664

2:3->1664x2496

21:9->3136x1344

4K分辨率下，宽高比/宽高像素值：

1:1->4096x4096

3:4->3520x4704

4:3->4704x3520

16:9->5504x3040

9:16->3040x5504

2:3 ->3328x4992

3:2 ->4992x3328

21:9->6240x2656

output_format?string

指定生成图像的文件格式。（仅 doubao-seedream-5.0-lite 支持该参）可选值：

png

jpeg

watermark?boolean

是否在生成的图片中添加水印。

false：不添加水印。

true：在图片右下角添加“AI生成”字样的水印标识。

image?string|

输入的图片信息，支持 URL 或 Base64 编码。其中，doubao-seedream-5.0-lite/4.5/4.0 支持单图或多图输入。

传入单张图片要求：

图片格式：jpeg、png（doubao-seedream-5.0-lite/4.5/4.0 模型新增支持 webp、bmp、tiff、gif、heic、heif 格式new）

宽高比（宽/高）范围：

[1/16, 16] (适用模型：doubao-seedream-5.0-lite/4.5/4.0）

宽高长度（px） > 14

大小：不超过 30MB

总像素：不超过 6000x6000=36000000 px （对单张图宽度和高度的像素乘积限制，而不是对宽度或高度的单独值进行限制）

doubao-seedream-5.0-lite/4.5/4.0 最多支持传入 14 张参考图。

seed?integer

随机数种子，用于控制模型生成内容的随机性。取值范围为 [-1, 2147483647]。(仅 doubao-seedream-3.0-t2i/seededit-3.0-i2i 支持该参)

sequential_image_generation?string

控制是否关闭组图功能。(仅 doubao-seedream-5.0-lite/4.5/4.0 支持该参)

auto：自动判断模式，模型会根据用户提供的提示词自主判断是否返回组图以及组图包含的图片数量。

disable：关闭组图功能，模型只会生成一张图。

sequential_image_generation_options?

组图功能的配置。仅当 sequential_image_generation 为 auto 时生效。(仅 doubao-seedream-5.0-lite/4.5/4.0 支持该参)

tools?

配置模型要调用的工具。(仅 doubao-seedream-5.0-lite 支持该参)

stream?boolean

控制是否开启流式输出模式。(仅 doubao-seedream-5.0-lite/4.5/4.0 支持该参)

false：非流式输出模式，等待所有图片全部生成结束后再一次性返回所有信息。

true：流式输出模式，即时返回每张图片输出的结果。在生成单图和组图的场景下，流式输出模式均生效。

response_format?string

指定生成图像的返回格式。支持以下两种返回方式：

url：返回图片下载链接；链接在图片生成后24小时内有效，请及时下载图片。

b64_json：以 Base64 编码字符串的 JSON 格式返回图像数据。

optimize_prompt_options?

提示词优化功能的配置。（仅 doubao-seedream-5.0-lite/4.5/4.0 支持该参）

Response Body

application/json

curl -X POST "https://api.aa.com.cn/api/v1/image/generation" \
  -H "Authorization: string" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "string",
    "prompt": "string"
  }'

curl -X POST "https://api.aa.com.cn/api/v1/image/generation" \  -H "Authorization: string" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "prompt": "string"  }'

{
  "code": 0,
  "data": {
    "urls": [
      "string"
    ],
    "usage": {
      "images": 0,
      "seconds": 0,
      "input_tokens": 0,
      "total_tokens": 0,
      "output_tokens": 0
    },
    "expired": "string",
    "task_id": "string",
    "task_status": "string"
  },
  "message": "string",
  "request_id": "string"
}

Header Parameters

Request Body

Response Body

200application/json

application/json