Seedream-5.0-lite（BytePlus 图片）

本文档依据火山引擎官方文档「图像生成 API（Image Generation API）」整理，接口说明与参数以官方为准。

本文描述图像生成 API 的请求与响应参数。

Request body（请求参数完整列表）

参数	类型	必填	说明
model	string	是	seedream-5-0-260128
prompt	string	是	用于图像生成的文本提示词。可与 size 方式一配合，在 prompt 中用自然语言描述宽高比、形状或用途，由模型决定宽高。建议不超过 600 个英文词，过长会分散信息导致模型忽略细节。
image	string ／ array	否	输入图片，Base64 字符串或可访问的 URL。Seedream-5.0-lite 单图或多图，最多 14 张参考图。详见下方「图片参数 image 说明」。
size	string	否	输出图像尺寸。两种指定方式不可同时使用： 方式一：分辨率描述（如 2K、3K）+ prompt 中描述宽高比 方式二：直接指定宽高像素。详见下方「尺寸参数 size 说明」
output_format	string	否	生成图片的文件格式，默认 jpeg。可选 png、jpeg
response_format	string	否	生成图片在 API 响应中的返回方式，默认 url。url：返回图片下载链接，有效期为生成后 24 小时；b64_json：在 JSON 响应中直接返回 Base64 编码的图片数据。
stream	boolean	否	是否开启流式输出，默认 false。false：处理完成后一次性返回所有图片；true：每生成一张即返回，适用于单张与批量生图。
sequential_image_generation	string	否	是否连续生成多张相关图片。 auto：根据输入生成一批相关图 disabled：仅生成单张
sequential_image_generation_options	object	否	批量连续生图配置。仅在 sequential_image_generation 为 auto 时生效；子参数 max_images：integer，默认 15，取值范围 [1, 15]，表示本次请求最多生成的图片数；实际生成数量由 max_images 与输入参考图数量共同决定，须满足 输入参考图数量 + 生成图片数 ≤ 15。
watermark	boolean	否	是否为生成图片添加水印，默认 true。false：不添加水印；true：在图片右下角添加水印。
optimize_prompt_options	object	否	提示词优化功能配置。子参数 mode：string，默认 standard。standard：质量更高、生成时间更长；fast：速度更快、质量一般。

图片参数 image 说明 {#doc-image-params}

• 输入方式：可传图片 URL（需可访问）或 Base64。Base64 格式为 data:image/<格式>;base64,<编码>，其中图片格式需小写（如 data:image/png;base64,...）。
• 多图：Seedream-5.0-lite 支持单图或多图；参考图最多 14 张。
• 图片格式：JPEG、PNG 通用；Seedream-5.0-lite 还支持 WEBP、BMP、TIFF、GIF。
• 宽高比：Seedream-5.0-lite 为 [1/16, 16]
• 尺寸与大小：宽高像素均需 > 14；单图不超过 10 MB；单图总像素（宽×高）不超过 6000×6000（36,000,000）。

尺寸参数 size 说明 {#doc-size-params}

输出尺寸有两种指定方式，不可同时使用。

方式一：自然语言。在请求中传入分辨率描述（如 2K、3K），并在 prompt 中描述宽高比、形状或用途，由模型决定具体宽高。

方式二：像素指定。直接指定宽、高像素值。默认 2048×2048。须同时满足：① 总像素（宽×高）在 [2560×1440, 3072×3072×1.1025]，即 [3,686,400, 10,404,496]；② 宽高比在 [1/16, 16]。例如 3750×1250 合法（总像素与宽高比均满足），1500×1500 不合法（总像素低于下限）。

分辨率与宽高像素对照

分辨率	宽高比	宽 × 高（像素）
2K	1:1	2048 × 2048
2K	4:3	2304 × 1728
2K	3:4	1728 × 2304
2K	16:9	2848 × 1600
2K	9:16	1600 × 2848
2K	3:2	2496 × 1664
2K	2:3	1664 × 2496
2K	21:9	3136 × 1344
3K	1:1	3072 × 3072
3K	4:3	3456 × 2592
3K	3:4	2592 × 3456
3K	16:9	4096 × 2304
3K	9:16	2304 × 4096
3K	2:3	2496 × 3744
3K	3:2	3744 × 2496
3K	21:9	4704 × 2016

返回参数

参数	类型	必填	说明
id	string	—	本次请求的唯一标识
created	integer	—	创建时间戳（Unix 秒）
data	array	—	输出图片信息列表，每项为一张图片的信息或错误对象。详见下方「data 字段详情」。
usage	object	—	当前请求的用量信息。详见下方「usage 字段详情」。
error	object	—	当前请求的错误信息（若有）。详见下方「error 字段详情」。

data 字段详情 {#doc-data-detail}

data 为数组，每项可能是成功时的图片信息（object）或失败时的错误信息（object）。使用 seedream-5.0-lite、4.5、4.0 批量生成时：若某张因内容过滤被拒，后续生成仍会请求、同请求内其他任务不受影响；若因内部服务错误 (500) 失败，则不再请求下一张。

成功时（图片信息）

参数	类型	说明
url	string	图片 URL，response_format 为 url 时返回。链接自生成起 24 小时内有效，请及时保存。
b64_json	string	图片 Base64 数据，response_format 为 b64_json 时返回。
size	string	图片宽高像素，格式 <宽>x<高>，如 2048x2048。仅 seedream-5.0-lite、4.5、4.0 支持。

失败时（错误信息）

参数	类型	说明
error	object	单张生成失败时的错误信息对象
error.code	string	失败时的错误码，参见 Error Codes
error.message	string	失败时的错误描述

usage 字段详情 {#doc-usage-detail}

当前请求的用量信息。

参数	类型	说明
generated_images	integer	模型成功生成的图片数量（不含失败）。计费按成功生成的图片数量计算。
output_tokens	integer	本次生成图片消耗的 token 数。计算方式：sum(图片宽 × 图片高) ／ 256 再四舍五入取整。
total_tokens	integer	本请求消耗的 token 总数。当前与 output_tokens 相同（输入 token 暂不参与计算）。

error 字段详情 {#doc-error-detail}

当前请求若发生错误，返回错误信息对象。

参数	类型	说明
code	string	错误码，参见 Error Codes
message	string	错误描述

cURL 示例

curl -X POST "$BASE_URL/v3/images/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-3-0-t2i-250415",
    "prompt": "A futuristic city at sunset, cinematic lighting",
    "size": "2K",
    "n": 1
  }'