图片生成
Header Parameters
使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx
Request Body
application/json
模型名称,固定值: 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
用于生成图像的提示词,支持中英文。
指定生成图像的尺寸信息
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。将您的输入图片尺寸与下表中的尺寸进行对比,选择最接近的,作为输出图片的尺寸。具体而言,会按顺序从可选比例中,选取与原图宽高比差值最小的第一个,作为生成图片的比例。
指定生成图像的文件格式。(仅 doubao-seedream-5.0-lite 支持该参)可选值:png jpeg
是否在生成的图片中添加水印。 false:不添加水印。 true:在图片右下角添加“AI生成”字样的水印标识。
输入的图片信息,支持 URL 或 Base64 编码。其中,doubao-seedream-5.0-lite/4.5/4.0 支持单图或多图输入(查看多图融合示例),doubao-seededit-3.0-i2i 仅支持单图输入。(doubao-seedream-3.0-t2i 不支持该参)
随机数种子,用于控制模型生成内容的随机性。取值范围为 [-1, 2147483647]。(仅 doubao-seedream-3.0-t2i/seededit-3.0-i2i 支持该参)
控制是否关闭组图功能。(仅 doubao-seedream-5.0-lite/4.5/4.0 支持该参)
组图功能的配置。仅当 sequential_image_generation 为 auto 时生效。(仅 doubao-seedream-5.0-lite/4.5/4.0 支持该参)
配置模型要调用的工具。(仅 doubao-seedream-5.0-lite 支持该参)
控制是否开启流式输出模式。(仅 doubao-seedream-5.0-lite/4.5/4.0 支持该参) false:非流式输出模式,等待所有图片全部生成结束后再一次性返回所有信息。 true:流式输出模式,即时返回每张图片输出的结果。在生成单图和组图的场景下,流式输出模式均生效。
模型输出结果与prompt的一致程度,生成图像的自由度,又称为文本权重;值越大,模型自由度越小,与用户输入的提示词相关性越强。(doubao-seedream-3.0-t2i 默认值 2.5doubao-seededit-3.0-i2i 默认值 5.5doubao-seedream-5.0-lite/4.5/4.0 不支) 取值范围:[1, 10] 。
指定生成图像的返回格式。支持以下两种返回方式: url:返回图片下载链接;链接在图片生成后24小时内有效,请及时下载图片。 b64_json:以 Base64 编码字符串的 JSON 格式返回图像数据。
提示词优化功能的配置。(仅 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"
}