Seedream 5.0 Pro Image Edit API

bytedance/seedream-v5.0-pro/edit
Up to 10 images · 1K/2K · JPEG/PNG

Seedream 5.0 Pro Image Edit API 接受自然语言提示词和 1–10 个有序图片 URL。可在提示词中写明每张图片的作用,以及对主体、产品细节、文字、版式、背景、材质、构图或视觉风格的修改要求;输出为 1K/2K JPEG 或 PNG 图片。

输入

665/10000
1/10
参考图片 1: Reference 1

图片编辑必填。上传 1–10 张 JPEG、PNG 或 WebP 图片,单张不超过 30 MB;API 会保持当前顺序。

体验区会显式发送 enable_safety_checker,默认值为 true。

已就绪
Seedream 5.0 Pro result
15 积分 × $0.005 = $0.075

继续使用

示例

blue-hour-edit.jpg

Edit only the environment and lighting of this still-life image. Preserve exactly the same clear glass vase, celadon bowl, folded linen cloth, object count, object shapes, surface textures, relative positions, camera angle, crop, and focal length. Change the north-window daylight into a quiet blue-hour scene after rain: cool ambient light from the window, a subtle warm reflection from outside the frame, faint raindrop bokeh beyond the window, and physically believable reflections on the glass and glaze. Keep the oak table and museum-study mood. Do not add or remove objects. No people, no brand, no logo, no packaging, no text, no advertisement, no watermark.

Seedream 5.0 Pro Image Edit API

Seedream 5.0 Pro Image Edit API 要求同时提供提示词和 1–10 个有序公开 HTTP(S) 图片 URL。提示词可按数组顺序引用每张来源图并描述修改要求;成功提交后返回异步图片任务。

为什么选择 Seedream 5.0 Pro Image Edit API?

  • 把编辑意图写成明确指令。用自然语言说明需要调整的区域、对象、文字、材质或版式,以及最终画面目标。

  • 写明需要保持辨识度的细节。在编辑提示词中列出需要延续的身份、产品结构、品牌元素、色彩、字体或构图。

  • 为最多十张图片分配角色。按顺序提供主体、产品、服装、环境、构图、光线或风格来源。

  • 描述编辑元素之间的关系。写明目标合成画面中的透视、比例、反射、材质和光线要求。

  • 把现有创意适配到新用途。修改文案、版式、背景和美术方向,再按八种比例、1K/2K 和 JPEG/PNG 交付。

参数说明

参数要求说明
prompt必填

用最多 10,000 个字符说明每张来源图的作用、需要保留的细节和目标修改。

image_urls必填

按顺序提供 1–10 个公开 HTTP(S) 图片地址,并在提示词中按相同顺序引用。

size可选

根据发布版位选择输出画面比例。

默认值1:14:33:416:99:162:33:221:9
resolution可选

选择输出分辨率档位。

默认值1K2K
output_format可选

选择编辑结果的文件格式。

默认值jpegpng
enable_safety_checker可选

设置本次请求的内容安全检查开关。

truefalse

使用方法

  1. 安排来源图角色把主要素材放在第一位,再依次添加产品细节、环境、构图、光线或风格来源。

  2. 写出保留清单明确身份、产品结构、品牌元素、文字、色彩和版式中需要保持一致的内容。

  3. 描述一个目标状态说明新的背景、材质、文案、布局或美术方向,并把每项修改对应到来源图。

  4. 选择输出规格根据版位选择画面比例,再确定 1K/2K 和 JPEG/PNG。

  5. 提交并检查结果运行请求并检查全部图片的主体一致性、文字准确度、边缘、反射和小尺寸细节。

计费

前端当前按每次编辑请求 15 积分估算。按每积分 $0.005 计算,所有支持的分辨率、比例、格式和源图数量预估均为 $0.075。

计费项目费率详情
前端请求估算每次 15 积分1–10 张源图及全部支持的输出参数使用相同前端估算值。

适用场景

  • 替换产品背景保持产品结构和品牌信息,同时更换环境与影棚视觉处理。

  • 制作营销变体保留主视觉,同时修改色彩、文字处理、裁切或季节性美术方向。

  • 多图视觉融合按顺序为源图片分配主体、服装、环境与风格角色。

  • 本地化创意适配保留核心图像,同时按指定语言和版位修改文字与布局。

实用技巧

  • 先列出精确的保留项,再描述任何修改。
  • 按数组顺序引用图片,例如第一张提供产品,第二张提供光线。
  • 使用背景、前景、左侧、右侧或中央主体等具体空间描述。
  • 把替换文字放在引号中,并指出需要修改的文字区域。
  • 描述一个连贯的目标状态,不要堆叠相互冲突的编辑方向。
  • 用于生产前,检查小字号文字和身份细节。

注意事项

  • image_urls 支持 1–10 个有序的公开 HTTP(S) 图片地址。
  • 主要素材放在数组第一位,辅助来源按数组顺序在 prompt 中引用。
  • size 支持八种画面比例,resolution 支持 1K/2K,output_format 支持 jpeg/png。
  • 请求会返回异步任务 ID;任务完成后从 data.files[].file_url 读取图片地址。

Seedream 5.0 Pro 图片编辑 API 常见问题

什么是 Seedream 5.0 Pro Image Edit API?

Seedream 5.0 Pro Image Edit API 接受提示词和 1–10 个有序公开 HTTP(S) 图片 URL。可在提示词中按顺序说明每张图片的作用以及需要延续或修改的内容;API 会返回异步图片任务。

如何调用 Seedream 5.0 Pro Image Edit API?

使用 Authorization: Bearer VIDGO_API_KEY 向 /api/generate/submit 发送 POST 请求,将 model 设为 seedream-v5.0-pro/edit,并把 prompt 与 image_urls 放入 input;请把 example.com 替换为自己的公开图片地址。

Seedream 5.0 Pro Image Edit 如何计费?

前端当前按每次请求 15 积分估算。按每积分 $0.005 计算,无论使用一张还是十张源图,支持的输出参数组合预估均为 $0.075。

Seedream 5.0 Pro Image Edit 接受哪些输入?

input 支持 prompt、包含 1–10 个有序公开 HTTP(S) 图片地址的 image_urls、size、resolution、output_format 和可选 enable_safety_checker。可在 prompt 中说明每张图片的作用,以及需要保留和修改的细节。

如何获取编辑后的图片?

轮询 GET /api/generate/status/{task_id},直到 finished 或 failed。成功时读取全部 data.files[].file_url;也可在提交时提供 callback_url。

应该选择哪个 Seedream 5.0 Pro API 模式?

请求包含 1–10 个有序源图 URL 时选择 Image Edit;请求只包含提示词、不包含源图时选择 Text-to-Image。