如何使用 Seedream V5.0 Pro Edit 图片编辑与生成 API API:图生图接入指南(2026)
Seedream V5.0 Pro Edit 图片编辑与生成 API API 接入教程:参数说明、价格与可直接运行的调用代码,先在 Playground 试玩再一行代码接入。
Seedream V5.0 Pro Edit 图片编辑与生成 API 是一款图生图模型(由 Doubao 提供):ByteDance 推出的 Seedream V5.0 Pro Edit 可基于单张图片或多参考图进行图片编辑与生成,最多支持 10 张参考图片,支持宽高比选择以及 1K / 2K 输出档位。开箱即用的 REST 推理 API,性能出色,无冷启动,价格实惠。在 NamiFusion 上可以在 Playground 直接试玩(提交前显示准确报价),再通过统一 REST API 一行代码接入,典型一次调用约 $0.050。
TL;DR
· 任务类型:图生图,由 Doubao 提供
· 价格:典型一次约 $0.050($1 = 100 积分),按量计费无订阅
· 上手路径:Playground 试玩(提交前显示报价)→ API Keys 建密钥 → 一个 POST 接入
· 可调参数:5 个(见下方参数表)
· 无平台水印,商用可用(遵守服务条款)
用 Seedream V5.0 Pro Edit 图片编辑与生成 API 能做什么?
社媒配图与封面:按帖子主题批量出图,统一风格后直接排期发布。
电商与广告素材:产品场景图、Banner 底图、A/B 测试的多版本视觉。
概念设计与灵感探索:角色、场景、风格板,用低成本快速迭代方向。
内容工作流串联:生成结果可直接作为图生视频或换脸的输入素材。
怎么调用这个 API?
1. 在 NamiFusion 注册并在 API Keys 页面创建密钥(注册送免费积分)。
2. 用下面的 cURL 示例提交任务,Header 带上 Bearer 密钥。
3. 用返回的 task_uuid 轮询任务状态,完成后取输出 URL。
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-pro/image-to-image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "Transform the input product photo into a polished premium e-commerce image with clean studio lighting, subtle realistic shadows, enhanced colors, sharper details, and a minimalist light gray background. Preserve the original product shape, materials, branding, and overall composition while improving clarity and visual appeal.",
"images": [
"https://kaito-1328216764.cos.ap-tokyo.myqcloud.com/uploads/images/2026-07-09/23c18ba5cb9d.png"
],
"resolution": "1k",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"有哪些参数?
prompt(提示词):必填
images(图片):必填
resolution(分辨率):可选,默认 "1k"
aspect_ratio(宽高比):可选
output_format(输出格式):可选,默认 "jpeg"
Seedream V5.0 Pro Edit 图片编辑与生成 API 的提示词怎么写?
1. 主体在前:先写画面主角与动作,再补环境、光线、风格("一名宇航员在雨中的霓虹街头奔跑,电影感,浅景深")。
2. 用具体名词代替形容词堆砌:"85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
3. 迭代时只改一个变量:固定 seed 复现结果,每次只调整一个描述词,才能知道是什么在起作用。
4. 负面信息放正面写:与其说"不要模糊",不如直接要"锐利对焦、清晰细节"。
价格是多少?
按次积分计价,典型一次调用约 $0.050($1 = 100 积分),实际价格随参数(分辨率/时长等)变化,Playground 里提交前会显示准确报价。
Seedream V5.0 Pro Edit 图片编辑与生成 API
面向单图与多参考图编辑的高质量图像生成模型,支持最多 10 张参考图片与 2K 输出。
Seedream V5.0 Pro Edit 是 ByteDance 推出的高级图片编辑模型,适用于基于单张图片或多张参考图片的可控生成与编辑任务。该模型兼顾高质量输出、强提示词遵循能力与灵活的宽高比选择,并提供无冷启动体验,适合生产级图像工作流与高频迭代场景。
🚀 关键特性
- 多参考图编辑:支持最多 10 张参考图片,可用于复杂构图、角色一致性、产品细节保留与风格迁移。
- 自然语言驱动编辑:通过提示词直接描述希望修改与保留的内容,降低复杂编辑流程门槛。
- 高质量专业输出:面向精修级图片编辑任务,具备较强的提示词遵循能力与稳定的视觉表现。
- 灵活宽高比支持:覆盖正方形、横屏、竖屏、超宽等多种宽高比,适配社交媒体、电商与营销素材需求。
- 1K / 2K 分层输出:可根据成本与清晰度需求选择 1K 或 2K 输出档位,兼顾快速迭代与最终成片。
- 无冷启动、响应稳定:适合在线应用与批量生产场景,减少等待时间并提升工作流连续性。
🛠️ 技术规格
| 项目 | 说明 |
|---|---|
| 模型架构 | 图像编辑 / 多参考图条件生成模型 |
| 模型类型 | text-to-image(基于输入图片进行编辑生成) |
| 输入 | 提示词 + 1~10 张参考图片 |
| 输出 | 1 张编辑后的图片 |
| 最大参考图片数量 | 10 张 |
| 宽高比 | 1:1、1:2、2:1、1:3、3:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、9:21、21:9 |
| 宽高比行为 | 留空时,将根据第一张输入图片自动匹配最接近的受支持宽高比 |
| 分辨率 | 1k、2k |
| 输出格式 | jpeg、png |
| 质量定位 | 专业级图片编辑与多图参考控制 |
| 延迟特性 | 无冷启动;实际推理时延取决于输入复杂度与输出档位 |
示例提示词
- 保持人物面部特征不变,将背景替换为现代极简风格的咖啡馆,自然光,真实摄影质感。
- 参考多张产品图,生成一张电商主图:白色背景,统一光照,突出材质细节与高级感。
- 保留服装款式与颜色,将模特姿势调整为站立侧身,适配 9:16 竖屏海报构图。
💰 价格
| 项目 | 价格 |
|---|---|
| 1k 输出 | $0.045 |
| 2k 输出 | $0.090 |
| 额外参考图片成本 | 每增加 1 张参考图片,$0.003 |
说明:首张输入图片已包含在基础价格中。
FAQ
可以先免费试用吗?+
注册即送积分,但赠送积分目前仅适用于应用内的部分换脸功能;本模型按量积分计费。Playground 仍可无代码试玩,提交前会显示准确报价。
生成内容可以商用吗?有水印吗?+
可以商用,NamiFusion 不给生成结果加平台水印;使用须遵守服务条款与适用法律。
内容政策是什么?+
NamiFusion 是无过滤引擎,不做武断限制、对 NSFW 友好,但禁止违法内容与非自愿的真人素材,详见服务条款。
Seedream V5.0 Pro Edit 图片编辑与生成 API 的任务要跑多久?+
取决于参数,图像通常数秒到数十秒,视频通常数十秒到几分钟;API 返回 task_uuid 供轮询。
分辨率/时长上限是多少?+
以模型参数表为准:每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。