主题
创建图片
POST
https://az.gptplus5.com/v1/images/generations
给定提示和/或输入图像，模型将生成新图像。
相关指南：图像生成
根据提示创建图像。
请求参数
Header 参数
| 参数名 | 类型 | 必需 | 说明 | 示例 |
|---|---|---|---|---|
Authorization | string | 可选 | Bearer {{YOUR_API_KEY}} |
Body 参数 (application/json)
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
model | string | 必需 | 支持：文生图 doubao-seedream-3-0-t2i-250415 支持：图片编辑 doubao-seededit-3-0-i2i-250628 支持：文生图、图生图 doubao-seedream-5-0-260128 doubao-seedream-4-5-251128 doubao-seedream-4-0-250828 |
prompt | string | 必需 | 用于生成图像的提示词。 |
image | 可选 | 输入的图片信息，支持 URL 或 Base64 编码。 * 图片URL：请确保图片URL可被访问。 * Base64编码：请遵循此格式data:image/<图片格式>;base64,<Base64编码>。注意 <图片格式> 需小写，如 data:image/png;base64,<base64_image>。 | |
size | 可选 | ||
seed | integer | 可选 | 仅 doubao-seedream-3.0-t2i/seededit-3.0-i2i 支持该参 随机数种子，用于控制模型生成内容的随机性。取值范围为 [-1, 2147483647]。 注意： 相同的请求下，模型收到不同的seed值，如：不指定seed值或令seed取值为-1（会使用随机数替代）、或手动变更seed值，将生成不同的结果。 相同的请求下，模型收到相同的seed值，会生成类似的结果，但不保证完全一致。 |
sequential_image_generation | string | 可选 | 仅 doubao-seedream-5.0-lite/4.5/4.0 支持该参 控制是否关闭组图功能；基于您输入的内容，生成的一组内容关联的图片。 auto：自动判断模式，模型会根据用户提供的提示词自主判断是否返回组图以及组图包含的图片数量。 disabled：关闭组图功能，模型只会生成一张图。 默认值 disabled |
sequential_image_generation_options | object | 可选 | 仅 doubao-seedream-5.0-lite/4.5/4.0 支持该参 组图功能的配置。仅当 sequential_image_generation 为 auto 时生效。 |
└ max_images | integer | 可选 | 指定本次请求，最多可生成的图片数量，取值范围： [1, 15] 默认值 15 |
guidance_scale | number | 可选 | 模型输出结果与prompt的一致程度，生成图像的自由度，又称为文本权重；值越大，模型自由度越小，与用户输入的提示词相关性越强，取值范围：[1, 10] 。 doubao-seedream-3.0-t2i 默认值 2.5 doubao-seededit-3.0-i2i 默认值 5.5 doubao-seedream-5.0-lite/4.5/4.0 不支持 |
output_format | string | 可选 | 仅 doubao-seedream-5.0 支持该参 指定生成图像的文件格式。可选值： png jpeg 默认值 jpeg |
response_format | string | 可选 | 指定生成图像的返回格式。支持以下两种返回方式： url：返回图片下载链接；链接在图片生成后24小时内有效，请及时下载图片。 b64_json：以 Base64 编码字符串的 JSON 格式返回图像数据。 默认值 url |
watermark | boolean | 可选 | 是否在生成的图片中添加水印。 false：不添加水印。 true：在图片右下角添加“AI生成”字样的水印标识。 默认值 true |
请求示例
json
{
"model": "doubao-seedream-5-0-260128",
"prompt": "充满活力的特写编辑肖像，模特眼神犀利，头戴雕塑感帽子，色彩拼接丰富，眼部焦点锐利，景深较浅，具有Vogue杂志封面的美学风格，采用中画幅拍摄，工作室灯光效果强烈。",
"size": "2K",
"output_format": "png",
"response_format": "url",
"watermark": false
}cURL 示例
bash
curl --location --request POST 'https://az.gptplus5.com/v1/images/generations' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "doubao-seedream-5-0-260128",
"prompt": "充满活力的特写编辑肖像，模特眼神犀利，头戴雕塑感帽子，色彩拼接丰富，眼部焦点锐利，景深较浅，具有Vogue杂志封面的美学风格，采用中画幅拍摄，工作室灯光效果强烈。",
"size": "2K",
"output_format": "png",
"response_format": "url",
"watermark": false
}'返回响应
🟢200Create image
响应 Body
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
created | integer | 必需 | |
data | array[object] | 必需 | |
└ url | string | 必需 |
响应示例
json
{
"created": 1749819664,
"data": [
{
"content_filter_results": {
"hate": {
"filtered": false,
"severity": "safe"
},
"self_harm": {
"filtered": false,
"severity": "safe"
},
"sexual": {
"filtered": false,
"severity": "safe"
},
"violence": {
"filtered": false,
"severity": "safe"
}
},
"prompt_filter_results": {
"hate": {
"filtered": false,
"severity": "safe"
},
"profanity": {
"detected": false,
"filtered": false
},
"self_harm": {
"filtered": false,
"severity": "safe"
},
"sexual": {
"filtered": false,
"severity": "safe"
},
"violence": {
"filtered": false,
"severity": "safe"
}
},
"revised_prompt": "A young, adorable sea otter floating in the ocean",
"url": "https://dalleproduse.blob.core.windows.net/private/images/6b0ee3bd-fe24-46c7-8ab8-85be87b00eaf/generated_00.png?se=2025-06-14T13%3A01%3A13Z&sig=9pLM1cLo1Af6FKRZc2AZSVxfSQBBBIyzfg0cOiT7C%2B0%3D&ske=2025-06-13T23%3A43%3A31Z&skoid=09ba021e-c417-441c-b203-c81e5dcd7b7f&sks=b&skt=2025-06-06T23%3A43%3A31Z&sktid=33e01921-4d64-4f8c-a055-5bdaffd5e33d&skv=2020-10-02&sp=r&spr=https&sr=b&sv=2020-10-02"
}
]
}