典名词元典名词元首页
API 文档
AI 模型接口图像豆包

图片生成

POST
/api/v1/image/generation

Header Parameters

Authorization*string

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

Request Body

application/json

model*string

模型名称,固定值: doubao-seedream-3-0-t2i-250415 doubao-seededit-3.0-i2i doubao-seedream-4-0-250828 doubao-seedream-5-0-260128 doubao-seedream-4-5

prompt*string

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

size?string

指定生成图像的尺寸信息

Doubao-Seedream-5.0-lite: 方式 1 | 指定生成图像的分辨率,并在prompt中用自然语言描述图片宽高比、图片形状或图片用途,最终由模型判断生成图片的大小。 可选值:2K、3K 方式 2 | 指定生成图像的宽高像素值: 默认值:2048x2048 总像素取值范围:[2560x1440=3686400, 3072x3072x1.1025=10404496] 宽高比取值范围:[1/16, 16]

Doubao-Seedream 4.5: 方式 1 | 指定生成图像的分辨率,并在prompt中用自然语言描述图片宽高比、图片形状或图片用途,最终由模型判断生成图片的大小。 可选值:2K、4K 方式 2 | 指定生成图像的宽高像素值: 默认值:2048x2048 总像素取值范围:[2560x1440=3686400, 4096x4096=16777216] 宽高比取值范围:[1/16, 16]

Doubao-Seedream 4.0: 方式 1 | 指定生成图像的分辨率,并在prompt中用自然语言描述图片宽高比、图片形状或图片用途,最终由模型判断生成图片的大小。 可选值:1K、2K、4K 方式 2 | 指定生成图像的宽高像素值: 默认值:2048x2048 总像素取值范围:[1280x720=921600, 4096x4096=16777216] 宽高比取值范围:[1/16, 16]

Doubao-SeedEdit-3.0-t2i: 默认值:1024x1024 单张图片像素取值范围: [512x512, 2048x2048]

Doubao-SeedEdit-3.0-i2i: 当前仅支持 adaptive。 adaptive。将您的输入图片尺寸与下表中的尺寸进行对比,选择最接近的,作为输出图片的尺寸。具体而言,会按顺序从可选比例中,选取与原图宽高比差值最小的第一个,作为生成图片的比例。

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 支持单图或多图输入(查看多图融合示例),doubao-seededit-3.0-i2i 仅支持单图输入。(doubao-seedream-3.0-t2i 不支持该参)

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 支持该参)

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:流式输出模式,即时返回每张图片输出的结果。在生成单图和组图的场景下,流式输出模式均生效。

guidance_scale?number

模型输出结果与prompt的一致程度,生成图像的自由度,又称为文本权重;值越大,模型自由度越小,与用户输入的提示词相关性越强。(doubao-seedream-3.0-t2i 默认值 2.5doubao-seededit-3.0-i2i 默认值 5.5doubao-seedream-5.0-lite/4.5/4.0 不支) 取值范围:[1, 10] 。

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"  }'
{
  "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"
}