You need to enable JavaScript to run this app.
AI 数据湖服务

AI 数据湖服务

请输入
  • 文档首页
    • AI 数据湖服务 方舟大模型系列图像生成图片生成（Seedream 系列模型）
复制全文
我的收藏
图像生成
图片生成（Seedream 系列模型）
复制全文
我的收藏
图片生成（Seedream 系列模型）

算子介绍

描述

Seedream 图片生成模型，可根据用户输入的文本或参考图像生成高质量图片，支持组图与流式输出。

使用限制

  • 组图与流式输出仅支持 doubao-seedream-4.5、doubao-seedream-4.0。
  • doubao-seedream-3.0-t2i 仅支持文生图。

核心功能

  • 文生图/图生图/组图生成
  • 支持流式输出（SSE）与非流式输出
  • 输出格式支持 url 与 b64_json

输入输出规范

  • 输入格式
    • prompt：string
    • image：图片 URL 或 Base64（可选，按模型能力）
    • size/response_format/stream 等控制参数
  • 输出格式
    • 非流式：code/message/data
    • 流式：SSE 事件流（partial_succeeded/partial_failed/completed/error）

注意与前提

细分项

注意与前提

费用

调用算子前，您需先了解使用算子时的模型调用费用，详情请参见大模型调用计费。

鉴权（API Key）

调用算子前，您需要先生成算子调用的API Key，并建议将API Key配置为环境变量，便于更安全地调用算子，详情请参见获取 API Key 并配置。

BaseURL

调用算子前，您需要先根据您当前使用的LAS服务所在地域，了解算子调用的BaseURL，用于配置算子调用路径参数取值。
详情请参见获取 Base URL，下文中的调用示例仅作为参考，实际调用时需替换为您对应地域的路径取值。

API 调用

图片生成（非流式）

POST https://operator.las.cn-beijing.volces.com/api/v1/online/images/generations

接口说明

调用 Seedream 图片生成模型进行文生图/图生图/组图生成（非流式）。

请求参数

参数

类型

必填

示例值

说明

model

string

是

doubao-seedream-4-5-251128

本次请求使用模型ID，支持：
doubao-seedream-4-5-251128、
doubao-seedream-4-0-250828、
doubao-seedream-3-0-t2i-250415。

prompt

string

是

一只戴着墨镜的橘猫，坐在海边，日落，超写实。

用于生成图像的提示词，支持中英文。建议不超过300个汉字或600个英文单词。

image

string / array

否

输入的图片信息，支持 URL 或 Base64 编码。

  • doubao-seedream-3.0-t2i 不支持该参数。
  • doubao-seedream-4.5、doubao-seedream-4.0 支持单图或多图输入。
  • Base64 格式：data:image/<图片格式>;base64,<Base64编码>，其中 <图片格式> 需小写。
  • 图片限制：格式 jpeg、png（doubao-seedream-4.5/4.0 额外支持 webp、bmp、tiff、gif）；宽高比范围 doubao-seedream-4.5/4.0 为 [1/16, 16]；宽高长度 > 14px；大小不超过 10MB；总像素不超过 6000x6000；doubao-seedream-4.5/4.0 最多支持 14 张参考图。

size

string

否

2048x2048

指定生成图像的尺寸信息。

  • doubao-seedream-4.5：支持 2K、4K 或指定宽高像素值；默认 2048x2048；总像素范围 [2560x1440, 4096x4096]；宽高比范围 [1/16, 16]。
  • doubao-seedream-4.0：支持 1K、2K、4K 或指定宽高像素值；默认 2048x2048；总像素范围 [1280x720, 4096x4096]；宽高比范围 [1/16, 16]。
  • doubao-seedream-3.0-t2i：仅支持指定宽高像素值；默认 1024x1024；单张图片像素范围 [512x512, 2048x2048]。

seed

integer

否

-1

仅 doubao-seedream-3.0-t2i。随机数种子，取值范围 [-1, 2147483647]。

sequential_image_generation

string

否

disabled

仅 doubao-seedeam-4.5、doubao-seedream-4.0 支持。auto 表示自动判断是否组图，disabled 表示只生成一张图。

sequential_image_generation_options

sequential_image_generation_options

否

仅 doubao-seedream-4.5、doubao-seedream-4.0 支持。仅当 sequential_image_generation=auto 生效。

sequential_image_generation_options.max_images

integer

否

15

最多生成图片数量。取值范围 [1, 15]；需满足“输入参考图数量 + 生成图片数量 ≤ 15”。

guidance_scale

float

否

2.5

doubao-seedream-4.5/4.0 不支持；doubao-seedream-3.0-t2i 默认 2.5。取值范围 [1, 10]。

response_format

string

否

url

返回图片格式：url 或 b64_json。生成图片格式为 jpeg。

watermark

boolean

否

true

是否添加“AI生成”水印。false 为不添加，true 为添加。

optimize_prompt_options

optimize_prompt_options

否

仅 doubao-seedream-4.5（当前仅标准模式）、doubao-seedream-4.0 支持。

optimize_prompt_options.mode

string

否

standard

提示词优化模式：standard（质量更高、耗时更长）或 fast（更快、质量一般）。

返回数据

参数

类型

示例值

说明

code

integer

200

状态码

message

string

success

消息

data

generate_response

生成结果

data.model

string

doubao-seedream-4-5-251128

本次请求使用的模型 ID（模型名称-版本）。

data.created

integer

1589478378

请求创建时间的 Unix 时间戳（秒）。

data.data

list of data_item

输出图像信息列表。

data.data.url

string

https://...

当 response_format=url 时返回。

data.data.b64_json

string

当 response_format=b64_json 时返回。

data.data.size

string

2048x2048

图像宽高像素值（仅 doubao-seedream-4.5/4.0 支持）。

data.data.error

error_info

图片生成失败时返回。

data.data.error.code

string

BadRequest

请参见错误处理。

data.data.error.message

string

Missing required parameter.

错误提示信息

data.usage

usage

本次请求的用量信息。

data.usage.generated_images

integer

1

模型成功生成的图片张数，不包含生成失败的图片。仅对成功生成图片按张数进行计费。

data.usage.output_tokens

integer

16384

模型生成的图片花费的 token 数量。计算逻辑为 计算 sum(宽*高)/256，然后取整。

data.usage.total_tokens

integer

16384

本次请求消耗的总 token 数量。
当前不计算输入 token，故与 output_tokens 值一致。

data.error

error_info

请求级错误信息。

data.error.code

string

BadRequest

请参见错误处理。

data.error.message

string

Missing required parameter.

错误提示信息

示例

请求示例

curl --location "https://operator.las.cn-beijing.volces.com/api/v1/images/generations" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer $LAS_API_KEY" \
--data '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "一只戴着墨镜的橘猫，坐在海边，日落，超写实。",
    "size": "2048x2048",
    "response_format": "url",
    "watermark": true
}'

返回示例

{
    "model": "doubao-seedream-4-5-251128",
    "created": 1764041608,
    "data": [
        {
            "url": "<image_url>",
            "size": "2048x2048"
        }
    ],
    "usage": {
        "generated_images": 1,
        "output_tokens": 16384,
        "total_tokens": 16384
    }
}

图片生成（流式）

POST https://operator.las.cn-beijing.volces.com/api/v1/online/images/generations

接口说明

调用 Seedream 图片生成模型进行文生图/图生图/组图生成（流式 SSE）。

请求参数

参数

类型

必填

示例值

说明

model

string

是

doubao-seedream-4-5-251128

本次请求使用模型ID，支持：doubao-seedream-4-5-251128、doubao-seedream-4-0-250828、doubao-seedream-3-0-t2i-250415。

prompt

string

是

一只戴着墨镜的橘猫，坐在海边，日落，超写实。

用于生成图像的提示词，支持中英文。建议不超过300个汉字或600个英文单词。

image

string / array

否

输入的图片信息，支持 URL 或 Base64 编码。

  • doubao-seedream-3.0-t2i 不支持该参数。
  • doubao-seedream-4.5、doubao-seedream-4.0 支持单图或多图输入。
  • Base64 格式：data:image/<图片格式>;base64,<Base64编码>，其中 <图片格式> 需小写。
  • 图片限制：格式 jpeg、png（doubao-seedream-4.5/4.0 额外支持 webp、bmp、tiff、gif）；宽高比范围 ddoubao-seedream-4.5/4.0 为 [1/16, 16]；宽高长度 > 14px；大小不超过 10MB；总像素不超过 6000x6000；doubao-seedream-4.5/4.0 最多支持 14 张参考图。

size

string

否

2048x2048

指定生成图像的尺寸信息。

  • doubao-seedream-4.5：支持 2K、4K 或指定宽高像素值；默认 2048x2048；总像素范围 [2560x1440, 4096x4096]；宽高比范围 [1/16, 16]。
  • doubao-seedream-4.0：支持 1K、2K、4K 或指定宽高像素值；默认 2048x2048；总像素范围 [1280x720, 4096x4096]；宽高比范围 [1/16, 16]。
  • doubao-seedream-3.0-t2i：仅支持指定宽高像素值；默认 1024x1024；单张图片像素范围 [512x512, 2048x2048]。

seed

integer

否

-1

仅 doubao-seedream-3.0-t2i。随机数种子，取值范围 [-1, 2147483647]。

sequential_image_generation

string

否

disabled

仅 doubao-seedream-4.5、doubao-seedream-4.0 支持。auto 表示自动判断是否组图，disabled 表示只生成一张图。

sequential_image_generation_options

sequential_image_generation_options

否

仅 doubao-seedream-4.5、doubao-seedream-4.0 支持。仅当 sequential_image_generation=auto 生效。

sequential_image_generation_options.max_images

integer

否

15

最多生成图片数量。取值范围 [1, 15]；需满足“输入参考图数量 + 生成图片数量 ≤ 15”。

stream

boolean

是

true

仅 doubao-seedream-4.5、doubao-seedream-4.0 支持。需设置为 true 以启用流式输出（SSE）。

guidance_scale

float

否

2.5

doubao-seedream-4.5/4.0 不支持；doubao-seedream-3.0-t2i 默认 2.5。取值范围 [1, 10]。

response_format

string

否

url

返回图片格式：url 或 b64_json。生成图片格式为 jpeg。

watermark

boolean

否

true

是否添加“AI生成”水印。false 为不添加，true 为添加。

optimize_prompt_options

optimize_prompt_options

否

仅 doubao-seedream-4.5（当前仅标准模式）、doubao-seedream-4.0 支持。

optimize_prompt_options.mode

string

否

standard

提示词优化模式：standard（质量更高、耗时更长）或 fast（更快、质量一般）。

返回数据

参数

类型

示例值

说明

type

string

image_generation.partial_succeeded

事件类型，可能为 image_generation.partial_succeeded、image_generation.partial_failed、image_generation.completed、error。

model

string

doubao-seedream-4-0-250828

本次请求使用的模型 ID ，格式为<模型名称>-<版本>。

created

integer

1589478378

本次请求创建时间的 Unix 时间戳（秒）。

image_index

integer

0

本次生图请求中，本次事件对应图片在请求中的序号。从0开始累加，不管生图是否成功，均会自动累加 1。

url

string

https://...

本次事件对应图片的下载 URL。当请求中配置字段 response_format 为 url 时返回。

b64_json

string

<base64>

本次事件对应图片的 Base64 编码。当请求中配置字段 response_format 为 b64_json 时返回。

size

string

2048x2048

图像的宽高像素值，格式<宽像素>×<高像素>，如 2048×2048。

usage

usage

本次请求的用量信息。

usage.generated_images

integer

1

模型成功生成的图片张数，不包含生成失败的图片。仅对成功生成图片按张数进行计费。

usage.output_tokens

integer

16384

模型生成的图片花费的 token 数量。计算逻辑为 计算 sum(宽*高)/256，然后取整。

usage.total_tokens

integer

16384

本次请求消耗的总 token 数量。
当前不计算输入 token，故与 output_tokens 值一致。

示例

请求示例

curl --location "https://operator.las.cn-beijing.volces.com/api/v1/images/generations" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer $LAS_API_KEY" \
--data '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "一只戴着墨镜的橘猫，坐在海边，日落，超写实。",
    "size": "2048x2048",
    "response_format": "url",
    "stream": true
}'

返回示例

{
    "type": "image_generation.completed",
    "model": "doubao-seedream-4-5-251128",
    "created": 1589478378,
    "usage": {
        "generated_images": 1,
        "output_tokens": 16384,
        "total_tokens": 16384
    }
}

错误码

HttpCode

错误码

错误信息

说明

400

Model.InvalidName

The model name is invalid.

模型名称不合法

401

Authorization.Missing

Missing Authorization.

缺少鉴权

401

ApiKey.Invalid

The api key is invalid.

API不合法

最近更新时间：2026.02.10 15:51:19
这个页面对您有帮助吗？
有用
有用
无用
无用