Seedream V5.0 Pro Edit 图片编辑与生成 API
doubao/seedream-v5.0-pro/image-to-image
ByteDance 推出的 Seedream V5.0 Pro Edit 可基于单张图片或多参考图进行图片编辑与生成,最多支持 10 张参考图片,支持宽高比选择以及 1K / 2K 输出档位。开箱即用的 REST 推理 API,性能出色,无冷启动,价格实惠。
示例
参数
| 名称 | 类型 | 默认 | 约束 | 说明 |
|---|---|---|---|---|
| prompt *提示词 | textarea | — | ≤ 5000 chars | 用于生成的正向提示词。 |
| images *图片 | image_upload | — | image/* · 1–10 items | 要编辑的图片。最多可上传 10 张参考图片。 |
| resolution分辨率 | select | 1k | 1k | 2k | 用于计费的输出分辨率档位。1k 为较低成本档位;2k 为较高成本档位。 |
| aspect_ratio宽高比 | select | — | 1:1 | 1:2 | 2:1 | 1:3 | 3:1 | 2:3 | 3:2 | 3:4 | … | 生成图片的宽高比。留空时,将根据第一张输入图片自动使用最接近的受支持宽高比。 |
| output_format输出格式 | select | jpeg | jpeg | png | 输出图片的格式。 |
API
通过统一 REST API 调用本模型;在 API Keys 页获取密钥。
cURL
# 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"Python
import time, requests
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1) Submit
resp = requests.post(
"https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-pro/image-to-image",
headers=HEADERS,
json={
"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"
}
},
)
resp.raise_for_status() # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()
# 2) Poll until a terminal state (completed / failed / cancelled).
# This model is allowed up to 300s server-side.
deadline = time.time() + 360
while task.get("status") not in ("completed", "failed", "cancelled"):
if time.time() > deadline:
raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
time.sleep(3)
poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
poll.raise_for_status()
task = poll.json()
print(task["status"], task.get("output"))JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };
// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-pro/image-to-image", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"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"
}
}),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();
// 2) Poll until a terminal state (completed / failed / cancelled).
// This model is allowed up to 300s server-side.
const deadline = Date.now() + 360 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
await new Promise((r) => setTimeout(r, 3000));
const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
task = await poll.json();
}
console.log(task.status, task.output);文档
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 |
说明:首张输入图片已包含在基础价格中。
💡 最佳使用场景
- 电商图片编辑:用于商品主图优化、背景替换、风格统一与营销素材制作。
- 品牌与广告创意:基于多张参考图快速生成符合品牌视觉规范的宣传图片。
- 角色与人物一致性生成:在多轮创作中保持人物身份、服饰、氛围与视觉风格一致。
- 社交媒体内容生产:快速生成适配不同平台宽高比的封面图、海报图与活动素材。
🔗 相关模型
- Seedream V5.0 Pro:适合纯提示词驱动的文本生图任务。
- Seedream V5.0 Lite Edit:更轻量的图片编辑模型,适合对成本与速度更敏感的场景。
相关模型
xAI Grok Imagine Image v2.0 图片编辑
xAI Grok Imagine Image V2.0 Edit 可根据文本提示词对输入图片进行编辑,并支持可配置的分辨率和质量,适用于精细图片编辑、视觉优化、创意变体、社交内容、营销素材和生产工作流。提供开箱即用的 REST 推理 API,性能出色,无冷启动,价格实惠。
Qwen Image 3.0 Pro Edit|快速图片编辑
Qwen Image 3.0 Pro Edit 是一款专业级图片编辑模型,具备出色的画质和高级指令理解能力。最高支持 2k。提供开箱即用的 REST inference API,性能优异,无冷启动,价格实惠。
图片换头
将照片中的人物头部替换为参考图中的头部。先上传目标照片,再上传头部参考图。
Nami Qwen I2I Spicy
使用自然语言指令编辑参考图片,并尽量保留未要求修改的内容。
Nano Banana 图像编辑
高性价比智能修图。 无需蒙版即可实现物体替换与风格迁移,极速响应,成本低廉。
Nano Banana Pro 图像编辑
4K 语义级修图。基于自然语言修改现有图像,支持智能光影融合与图像内多语言文字编辑。
Nano Banana 2 图像编辑
4K 语义级修图。基于自然语言修改现有图像,支持智能光影融合与图像内多语言文字编辑。
Seedream 5.0 Lite Edit Sequential
Seedream 5.0 Lite Edit Sequential支持多图编辑,同时锁定角色和物体在不同画面中的一致性。它可以检测主要主体,保持连贯性,并进行受控编辑,支持最高4K输出。提供即用型REST推理API,性能最佳,无冷启动,价格实惠。