如何使用 qwen-image-edit-spicy API:图生图接入指南(2026)
qwen-image-edit-spicy API 接入教程:参数说明、价格与可直接运行的调用代码,先在 Playground 试玩再一行代码接入。
qwen-image-edit-spicy 是一款图生图模型:通过文本指令精确编辑图片,可添加、移除或修改画面元素,也支持风格迁移和背景替换,适合照片修饰与视觉设计。在 NamiFusion 上可以在 Playground 直接试玩(提交前显示准确报价),再通过统一 REST API 一行代码接入,典型一次调用约 $0.040。
TL;DR
· 任务类型:图生图
· 价格:典型一次调用约 $0.040($1 = 100 积分),按量计费无订阅
· 上手路径:Playground 试玩(提交前显示报价)→ API Keys 建密钥 → 一个 POST 接入
· 可调参数:3 个(见下方参数表)
· 无平台水印,商用可用(遵守服务条款)
用 qwen-image-edit-spicy 能做什么?
社媒配图与封面:按帖子主题批量出图,统一风格后直接排期发布。
电商与广告素材:产品场景图、Banner 底图、A/B 测试的多版本视觉。
概念设计与灵感探索:角色、场景、风格板,用低成本快速迭代方向。
内容工作流串联:生成结果可直接作为图生视频或换脸的输入素材。
怎么调用这个 API?
- 在 NamiFusion 注册并在 API Keys 页面创建密钥(注册赠送积分仅可用于指定模型)。
- 用下面的 cURL 示例提交任务,Header 带上 Bearer 密钥。
- 用返回的 task_uuid 轮询任务状态,完成后取输出 URL。
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/qwen-image-edit-spicy" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"image": [
"https://assets-public.namifusion.com/marketplace/images/2026-06-12/638e1ee18ac7.jpeg"
],
"prompt": "Replace the background with a clean modern studio, add soft directional lighting, and preserve the subject identity and fine details."
}
}'
# 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"有哪些参数?
image(输入图片):必填
prompt(编辑指令):必填
seed(随机种子):可选
qwen-image-edit-spicy 的提示词怎么写?
- 主体在前:先写画面主角与动作,再补环境、光线、风格("一名宇航员在雨中的霓虹街头奔跑,电影感,浅景深")。
- 用具体名词代替形容词堆砌:"85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
- 迭代时只改一个变量:固定 seed 复现结果,每次只调整一个描述词,才能知道是什么在起作用。
- 负面信息放正面写:与其说"不要模糊",不如直接要"锐利对焦、清晰细节"。
价格是多少?
按次积分计价,典型一次调用约 $0.040($1 = 100 积分),实际价格随参数(分辨率/时长等)变化,Playground 里提交前会显示准确报价。
qwen-image-edit-spicy
通过提示词精确编辑源图片,同时保留不应变化的关键细节。
qwen-image-edit-spicy 是一款面向单图编辑的模型,可根据自然语言指令对一张输入图片进行转换。它适合背景替换、视觉风格调整、光线变化、对象级修改和创意版本制作。参数结构简洁直接:提供图片、说明希望进行的编辑,并可选填随机种子,以便在优化提示词时生成更便于比较的结果。
核心特性
- 指令驱动编辑:根据明确的文字要求判断源图片中哪些内容需要修改。
- 关键内容保留:可在提示词中指定保留人物身份、构图、品牌标识、材质或其他重要细节。
- 多种创意调整:单次请求可处理背景、灯光、色彩、氛围与风格变化。
- 输入结构简单:仅需一张图片和一条编辑指令,便于快速测试与接入。
- 支持 URL 与 base64:Marketplace 上传控件可接收在线图片或 base64 图片数据。
- 随机种子控制:可选种子有助于在修改提示词时获得便于横向比较的变体。
技术规格
| 项目 | 说明 |
|---|---|
| 任务类型 | 图片编辑 / 图片转图片 |
| 必填输入 | image、prompt |
| 图片输入 | 一张图片 URL 或 base64 数据 |
| 提示词长度 | 最多 5,000 个字符 |
| 可选输入 | seed,从 0 开始的整数 |
| 输出 | 生成图片 URL |
| 典型流程 | 源图片加一条具体编辑指令 |
示例提示词
将背景替换为干净的现代摄影棚,增加柔和的定向灯光,同时保留人物身份、姿态和服装。保持商品形状、Logo 和材质不变,将其放在深色反光台面上,使用高级商业摄影灯光。将场景调整为冷色电影感的雨夜,同时保留所有人物和原始构图。
计费
| 计费项 | 价格 |
|---|---|
| 每张编辑图片 | 4 积分 |
以上数值原样反映现有 Marketplace 计费配置,本次文档修复不会修改价格。
常见问题
可以先免费试用吗?+
注册赠送积分仅可用于指定模型,适用范围会持续更新;Playground 提交前会显示准确报价。
生成内容可以商用吗?有水印吗?+
可以商用,NamiFusion 不给生成结果加平台水印;使用须遵守服务条款与适用法律。
内容政策是什么?+
色情内容、涉及未成年人的性化内容、未经授权使用真人、欺骗性冒充、诈骗与虚假代言均禁止。合法、自愿且非露骨的成年人主题可能被允许,详见服务条款。
qwen-image-edit-spicy 的任务要跑多久?+
取决于参数,图像通常数秒到数十秒,视频通常数十秒到几分钟;API 返回 task_uuid 供轮询。
分辨率/时长上限是多少?+
以模型参数表为准:每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。