Skip to main content
byteplus/seededit-3-0-i2i-250628 的 API 参考文档,由 Comfy Router 提供,模型来自 BytePlus。

快速开始

你的 Comfy 工作区中创建一个密钥,并将其导出为 COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK(pip install comfy-sdknpm install @comfyorg/sdk);cURL 代码片段则是通过原始 HTTP 执行的同一调用。 模型 ID: byteplus/seededit-3-0-i2i-250628 端点: POST https://api.comfy.org/v2/models/byteplus/seededit-3-0-i2i-250628

架构

输入

number
控制输出图像与输入提示词的契合程度。范围 [1, 10]。值越高,对提示词的遵循度越强。seedream-3-0-t2i-250415 的默认值为 2.5,seededit-3-0-i2i-250628 的默认值为 5.5。seedream-5.0-pro、5.0-lite、4.5 和 4.0 不支持该参数。Range: 1 to 10Format: float
string | string[]
seedream-5.0-pro、5.0-lite、4.5 和 4.0,以及 seededit-3.0-i2i 支持此参数。输入待编辑图像的 Base64 编码或可访问的网址。seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持输入单张图像或多张图像(参见多图融合示例),而 seededit-3.0-i2i 仅支持单张图像输入。• 图片网址:请确保图片网址可访问。 • Base64 编码:格式必须为 data:image/<图像格式>;base64,<Base64 编码>。注意:<图像格式> 必须为小写,例如 data:image/png;base64,<base64_image>。Comfy Router 将整个 JSON 请求限制为 10 MiB,其中包括 base64 膨胀后的数据以及所有参考图像。对于会超出该传输限制的输入,请使用网址。输入图像必须满足以下要求: • 图像格式:jpeg、png(seedream-5.0-pro、5.0-lite、4.5 和 4.0 还支持 webp、bmp、tiff 和 gif;seedream-5.0-pro 还支持 heic 和 heif) • 宽高比(宽度/高度):seedream-5.0-pro、5.0-lite、4.5 和 4.0 在 [1/16, 16] 范围内;seededit-3.0-i2i 在 [1/3, 3] 范围内 • 宽度和高度(px):> 14 • 大小:不超过 10 MB(seedream-5.0-pro 为 30 MB) • 总像素:seedream-5.0-pro 不超过 6000x6000(36,000,000 px) • 最多 14 张参考图像(seedream-5.0-pro 为 10 张)在图层分离场景中(启用 layer_decomposition),image 为必填项,且仅支持单张输入图像(传入多张图像会返回错误)。输入图像必须为 png、jpeg、webp、bmp、tiff 或 gif(不支持 heic 和 heif),大小不超过 30 MB,总像素在 [512x512, 6000x6000] 范围内,宽高比在 [1/16, 16] 范围内。
boolean
默认值:"false"
控制是否启用图层分离。仅 seedream-5.0-pro 支持该参数。 true:图层分离模式。模型将单张输入图像分解为一张基础图像加多个图层(最多 16 个),并返回每个生成图层的位置和内容信息,包括堆叠顺序(z_index)、边界框(bounding_box)、名称(name)和描述(description)。 false:标准图像生成模式,不执行图层分离。 关于图层分离模式的说明:仅支持单张输入图像(传入多张图像会返回错误);如果任一图层生成失败,整个请求都会失败,不支持部分成功;最多返回 17 张图像(1 张基础图像 + 16 个图层)。传入 sequential_image_generation、sequential_image_generation_options、tools 和 stream 会返回错误。
string
模型标识符。支持的模型:seedream-3-0-t2i-250415、seededit-3-0-i2i-250628、seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128 和 seedream-5-0-pro-260628。直接以 v1 调用 POST /proxy/byteplus/api/v3/images/generations 时必须提供该参数,代理会拒绝任何其他值,若省略则返回 400。它不在本 schema 的 required 列表中,因为 Comfy Router 会从 /v2/models/byteplus/{model} 的 {model} 路径段中填充它,因此 Router 调用方会省略它。
object
提示词优化功能的配置。仅 seedream-5.0-pro/5.0-lite/4.5(仅支持 standard 模式)和 seedream-4.0 支持该参数。
string
默认值:"\"standard\""
设置提示词优化功能的模式。standard = 质量更高,生成时间更长。fast = 速度更快,但质量较为一般。Possible values: standard, fast
string
默认值:"\"jpeg\""
指定输出图像的格式。仅 seedream-5.0-pro 和 5.0-lite 支持该参数。在图层分离场景中,output_format 仅控制基础图像的格式;每个图层始终以 png 格式输出。Possible values: png, jpeg
string
用于图像生成或变换的文本描述。 在图层分离场景中为可选项(seedream-5.0-pro 且启用 layer_decomposition):如果提供了提示词,模型会根据提示词意图识别并分离你指定的元素;如果未提供提示词,模型会自动检测图像中的所有主要元素,并将其分离为独立的图层。
string
默认值:"\"url\""
指定响应中返回的生成图像的格式Possible values: url, b64_json
integer
默认值:"-1"
用于控制图像生成随机性的随机种子。范围:[-1, 2147483647]。如果未指定,将自动生成一个种子。要复现相同的输出,请使用相同的种子值。Range: -1 to 2147483647
string
控制是否禁用批处理生成功能。该参数仅在 seedream-5.0-lite、4.5 和 4.0 上受支持(seedream-5.0-pro 不支持)。有效值: auto:在自动模式下,模型会根据用户提示词自动判断是否返回多张图像,以及将包含多少张图像。 disabled:禁用批处理生成功能。模型将只生成一张图像。Possible values: auto, disabled
object
仅 seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro 不支持)。 批处理图像生成功能的配置。仅当 sequential_image_generation 设置为 auto 时,此参数才生效。
integer
默认值:"15"
指定本次请求中生成图像的最大数量。输入参考图像数量 + 生成图像数量 ≤ 15。范围:115
string
“seedream-3-0-t2i-250415”:指定生成图像的尺寸(宽 x 高,单位为像素)。必须介于 [512x512, 2048x2048] 之间 “seededit-3-0-i2i-250628”:生成图像的宽度和高度像素值。目前仅支持 adaptive。 “seedream-4-0-250828”:设置生成图像的规格。有两种方法,但不能同时使用。 方法 1 | 指定分辨率。可选值:1K、2K、4K 方法 2 | 指定宽度和高度像素值。默认:2048x2048,总像素:[1024x1024, 4096x4096],宽高比:[1/16, 16] “seedream-4-5-251128”:有两种可用方法。 方法 1 | 指定分辨率。可选值:2K、4K 方法 2 | 指定宽度和高度像素值。默认:2048x2048,总像素:[2560x1440, 4096x4096],宽高比:[1/16, 16] “seedream-5-0-260128”:有两种可用方法。 方法 1 | 指定分辨率。可选值:2K、3K 方法 2 | 指定宽度和高度像素值。默认:2048x2048,总像素:[2560x1440, ~3072x3072],宽高比:[1/16, 16] “seedream-5-0-pro-260628”:有两种可用方法(不能同时使用)。 方法 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;最终尺寸由模型决定。可选值:1K、2K 方法 2 | 指定宽度和高度像素值。默认:1024x1024,总像素:[1024x1024 (1048576), 2048x2048 (4194304)],宽高比:[1/16, 16] 启用 layer_decomposition 的 “seedream-5-0-pro-260628”:仅支持分辨率级别的方法。可选值:1K、1.5K、2K、auto。默认:auto。 基础图像按指定分辨率输出,并保留原始输入图像的宽高比;每个图层按接近指定分辨率输出,并保留其在原始图像中的宽高比。 auto:根据输入图像的尺寸和宽高比输出。介于 [1280x720, ~2048x2048] 之间的输入按原始输入尺寸输出;小于 1K 的输入按 1K 输出;大于 2K 的输入按 2K 输出。
boolean
默认值:"false"
Comfy Router 会将显式提供的 stream 标记设为 false,因为它会捕获完整的 JSON 结果。在 v1 代理上,此字段控制是否启用流式输出模式。仅 seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro 不支持)。false = 所有输出图像一次性返回。true = 每张输出图像生成后立即返回。
boolean
默认值:"true"
指定是否为生成图像添加水印。false = 不添加水印,true = 添加带有 “AI generated” 标签的水印
由 Router 在 GET /v2/models/byteplus/seededit-3-0-i2i-250628/openapi.json 提供的 schema 生成,该文档与请求到达提供商之前用于校验调用的文档相同。

输出

integer
Unix 时间戳(以秒为单位),表示请求的创建时间
object[]
包含所生成图像的信息。 在图层分离场景中,数组的第一个元素是基础图像(z_index=0),后续元素是各图层,按 z_index 递增排序。
string
Base64 编码的图像数据(当 response_format 为 “b64_json” 时)
object
当前图层在基础图像中所占区域的边界框信息。仅图层会返回该字段;基础图像覆盖整个画布,不返回 bounding_box。仅当 layer_decomposition 为 true 时返回。
integer[]
图层边界框的绝对像素坐标,以输出基础图像的坐标系为准,左上角为 (0, 0)。坐标格式:[left, top, right, bottom]。
integer[]
图层边界框的千分位量化(归一化)坐标,根据基础图像尺寸按比例映射到 [0, 1000] 的离散整数范围,最大截断为 1000。坐标格式:[left, top, right, bottom]。
string
当前分离元素的详细描述,相比 name 提供更丰富的图层特征(如颜色、状态、材质)。仅图层会返回该字段;基础图像不返回。仅当 layer_decomposition 为 true 时返回。
string
当前分离元素的名称/标签,由模型根据分离主体的特征自动生成。仅图层会返回该字段;基础图像不返回。仅当 layer_decomposition 为 true 时返回。
string
输出图像的文件格式。仅 seedream-5.0-pro 支持该字段。
string
图像的宽度和高度(以像素为单位),格式为 <width>x<height>。仅 seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持该参数。
string (uri)
用于下载图像的 URL(当 response_format 为 “url” 时)Format: uri
integer
图层的堆叠顺序,从下到上递增:0 是最底层的图层(基础图像);数值越大位置越高。可使用它按正确的堆叠顺序将各图层重新合成为完整图像。仅当 layer_decomposition 为 true 时返回。
object
错误信息(如有)
string
错误码
string
报错信息
string
请求所使用的模型 ID
object
integer
模型生成的图像数量
integer
输入到模型的图像数量。仅 seedream-5.0-pro 支持该字段。
integer
模型生成图片所使用的 token 数量。
integer
本次请求消耗的 token 总数。

示例

输入

输出

发布前须知

SDK 会生成 Idempotency-Key 并在自动重试中复用它。手动重试时,请复用原始 key。Router 最长可保持连接 10 分钟。 请求失败时,Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入。生成的资源请及时下载,因为结果链接会过期

请求头

身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。

使用 Router API

模型发现、校验错误、重试与计费。

限制

Router 目前不支持的功能,以及替代方案。