创建时间: 2026-07-03 16:29 | 步骤: 2 个
基于输入人物原图与背景素材图,通过全局固定画图提示词,自动将人物和背景融合,生成高分辨率、风格统一的合成图像。
{
"workflow_id": "smart_portrait_background_replace",
"input": {
"portrait_image": {
"field_name": "portrait_image",
"default": "",
"description": "带人物主体的原图(支持真人/二次元),传入标准 Base64 编码字符串或普通 URL",
"example": "https://oss.showapi.com/doc/4888/3/abf2436f03b2_1782280969907.jpg?x-oss-process=image/resize,p_100",
"type": "base64",
"required": true
},
"bg_img": {
"field_name": "bg_img",
"default": "",
"description": "替换用背景素材图(场景、风景、纯色、室内外景均可),传入标准 Base64 编码字符串或普通 URL",
"example": "https://oss.showapi.com/doc/4888/3/1cb69e35cac8_1779935636689.jpg?x-oss-process=image/resize,p_100",
"type": "base64",
"required": true
},
"aspect_ratio": {
"field_name": "aspect_ratio",
"default": "3:4",
"description": "图像宽高比枚举:1:1、3:4、4:3、16:9、9:16;未传或非法值默认降级为 3:4",
"example": "9:16",
"type": "string",
"required": false
}
},
"steps": [
{
"id": "step_1_submit_image_task",
"point_code": "1",
"result": [],
"api_code": "3373",
"backend_type": "sys_api",
"status": "PENDING",
"name": "提交人物背景替换生图任务",
"action": "run",
"params": {
"referImages": [
"{{@input.bg_img}}",
"{{@input.portrait_image}}"
],
"prompt": "上传图像中的第一个图是背景图,第二个图是人物图,请将其进行人物背景替换:将图2的背景替换为图1的,且替换专属服饰;要求:整体画面风格统一,人物面容表情、动作姿态、发型贴合背景,整体协调自然;高分辨率摄影输出质感;",
"aspect_ratio": "{{@input.aspect_ratio}}"
}
},
{
"id": "step_2_poll_image_status",
"point_code": "",
"result": [],
"api_code": "polling",
"backend_type": "sys_api",
"status": "PENDING",
"name": "轮询生图任务状态",
"action": "run",
"params": {
"result_url": "{{@step_1_submit_image_task.result.data.result_url}}"
},
"depends_on": [
"step_1_submit_image_task"
],
"polling": {
"interval_seconds": 5,
"timeout_seconds": 120,
"success_condition": "{{@step_2_poll_image_status.result.data.task_status}} === 'SUCCEEDED'"
}
}
],
"output": {
"process_status": {
"field_name": "process_status",
"description": "任务最终状态枚举(SUCCESS / FAILED / TIMEOUT)",
"value": "{{@step_2_poll_image_status.result.data.task_status}}",
"type": "string"
},
"generated_image": {
"field_name": "generated_image",
"description": "最终合成的高分辨率图像URL",
"value": "{{@step_2_poll_image_status.result.data.result_url}}",
"type": "string"
},
"applied_config": {
"field_name": "applied_config",
"description": "审计追溯对象,包含实际生效的运行参数及全局固定提示词快照",
"value": {
"fixed_prompt": "上传图像中的第一个图是背景图,第二个图是人物图,请将其进行人物背景替换:将图2的背景替换为图1的,且替换专属服饰;要求:整体画面风格统一,人物面容表情、动作姿态、发型贴合背景,整体协调自然;高分辨率摄影输出质感;",
"aspect_ratio": "{{@input.aspect_ratio}}"
},
"type": "object"
}
}
} 提交后立即返回 task_id,系统每 2 秒自动轮询一次运行状态并可视化执行步骤,适合耗时较长的 Skill。
portrait_image必填base64带人物主体的原图(支持真人/二次元),传入标准 Base64 编码字符串或普通 URL
bg_img必填base64替换用背景素材图(场景、风景、纯色、室内外景均可),传入标准 Base64 编码字符串或普通 URL
aspect_ratiostring图像宽高比枚举:1:1、3:4、4:3、16:9、9:16;未传或非法值默认降级为 3:4
把这个 Skill 接入你的应用或 AI Agent —— 自带 REST API、OpenAPI 规范与 Agent 技能包。
下载技能包导入 AI Agent 客户端,即可作为技能使用
appKey={AppKey},与 API 文档一致。Agent 技能包接入教程 帮助文档
不知道如何接入?跟随图文步骤一步步完成配置
不同 Agent 客户端对技能包名称格式有不同要求,请选择你使用的客户端下载对应版本。
WorkBuddy
腾讯 Agent 客户端
DuMate
EN百度智能体 · 英文名称
阿里悟空
EN阿里 Agent · 英文名称
QoderWork CN
EN编程智能体 · 英文名称
QwenPaw
通义千问 Agent
Trae Work
字节跳动 Agent
有道 LobsterAI
网易有道智能体
智谱 AutoClaw
智谱 AI Agent
CodeX
ENCodex AI Agent
标注 EN 的客户端要求 Skill 英文命名,其余使用中文命名版本。

7*24小时服务
保证您的售后无忧

1v1专属服务
保证服务质量

担保交易
全程担保交易保证资金安全

服务全程监管
全周期保证商品服务质量
© 2015-2023 WWW.SHOWAPI.COM ALL RIGHTS RESERVED.昆明秀派科技有限公司
本网站所列接口及文档全部由SHOWAPI网站提供,并对其拥有最终解释权 POWERED BY SHOWAPI