---
title: "图像主体背景替换 AI Skill | 万维易源"
canonical_url: "https://www.showapi.com/ai/skills/6a97b9f33c51f24167049bdc?sub=api-ref&tab=integrate"
last_updated: "2026-09-08T18:47:40.886Z"
meta:
  description: "基于用户上传的主体图和背景图，使用固定的构图提示词调用默认生图引擎进行主体背景融合生成，并轮询获取最终图像结果。 免费在线使用，也支持 API / Agent 接入。"
  keywords: "图像主体背景替换 AI Skill Skills市场 AI技能 在线使用 API接入 showapi，万维易源，易源接口，api开放平台，开放api，api大全，api接口，接口中心，接口大全，开放平台，api，大数据，接口，API"
  "og:description": "基于用户上传的主体图和背景图，使用固定的构图提示词调用默认生图引擎进行主体背景融合生成，并轮询获取最终图像结果。 免费在线使用，也支持 API / Agent 接入。"
  "og:title": "图像主体背景替换 AI Skill"
---

*

*

*

*

# **图像主体背景替换**

基于用户上传的主体图和背景图，使用固定的构图提示词调用默认生图引擎进行主体背景融合生成，并轮询获取最终图像结果。

M**Marwen** 2026-09-02 14:09 · 3 个步骤

ID`6a97b9f33c51f24167049bdc`

把这个 Skill 接入你的应用或 AI Agent —— 自带 REST API、OpenAPI 规范与 Skill 技能包。

Skill 为**异步调用**过程：先提交执行拿到 `task_id`，再轮询查询任务状态与结果。下方按调用顺序列出两个端点。

`https://route.showapi.com/flow/execute/{flow_id}?appKey={AppKey}`

鉴权：URL 查询参数 `appKey={AppKey}`

Content-Type: application/json [获取 AppKey](https://www.showapi.com/console#/myApp)

#### 请求体参数 (Request Body)

subject\_imagebase64必填

带核心主体的原图，支持传入标准 Base64 编码字符串或普通 URL。画面主体为核心对象。

bg\_imgbase64必填

替换用背景素材图，支持传入标准 Base64 编码字符串或普通 URL。场景、风景、室内外景等均可。

aspect\_ratiostring

生成图像的宽高比，可选值：1:1、3:4、4:3、16:9、9:16

响应：提交成功返回 task\_id

**API 响应结构 (Response Schema)**1 个字段

原始 Schema

| |
|

| |
|

`https://route.showapi.com/flow/task/query/{task_id}?appKey={AppKey}`

鉴权：URL 查询参数 `appKey={AppKey}`

Content-Type: application/json [获取 AppKey](https://www.showapi.com/console#/myApp)

用第 ① 步返回的 task\_id 替换 URL 中的 {task\_id} 轮询，建议 1-2 秒一次，直到 status 为 SUCCESS 或 FAILED；step\_status\_list 可用于可视化执行进度。

响应：任务状态与结果

**API 响应结构 (Response Schema)**33 个字段

原始 Schema

| |
|

| |
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |

**执行中途出错时**

`status` 返回 `FAILED`， `remark` 给出错误信息； `step_status_list` 仅包含已执行到的部分阶段， `output` 为已产出的部分结果（可能为空或不完整）。

### 通用响应说明

#### 系统级返回

所有 API 响应均使用平台统一封装，业务数据嵌套在 `showapi_res_body` 中

| |
|

| |
|
| |
| |
| |
| |

#### 错误码 (showapi\_res\_code)

| |
|

| |
|
| |
| |

### **调用代码 **

代码示例根据当前 **输入参数**实时生成。 **异步调用一并提供"执行"与"查询任务"两个步骤的完整代码**，可按序集成。

**调用代码**

cURLPythonJavaScriptJavaGoPHPC#RubyRust

运行 Skill查询任务状态

POSThttps://route.showapi.com/flow/execute/6a97b9f33c51f24167049bdc?appKey={AppKey}

提交任务后立即返回 task\_id，需配合步骤 ② 轮询执行状态与结果

```
curl \
  -g 'https://route.showapi.com/flow/execute/6a97b9f33c51f24167049bdc?appKey={AppKey}' \
  -H 'Content-Type: application/json' \
  -d '{
  "subject_image": "https://oss.showapi.com/doc/4888/3/1cb69e35cac8_1779935636689.jpg?x-oss-process=image/resize,p_100",
  "bg_img": "https://oss.showapi.com/doc/4888/163/5ac066bad35d_1788337495986.jpg?x-oss-process=image/resize,p_100",
  "aspect_ratio": "1:1"
}'
```

响应示例：{ "code": 0, "data": { "task\_id": "69ddd187e13823d1d500015b" } }

请在 URL 查询参数 `appKey` 中携带你的 AppKey（如 `?appKey=你的AppKey`），不要在前端代码中硬编码生产 凭证，建议通过环境变量或后端代理注入。 [前往控制台获取 AppKey](https://www.showapi.com/console#/myApp)

### **OpenAPI 规范 **

标准 **OpenAPI 3.0** 规范文档，可导入 Apifox / Postman / Swagger Editor / Dify，或直接交给 AI Agent 读取以自动接入本 Skill。 提供 **YAML** 与 **JSON** 两种格式，支持浏览器在线查看与直接下载。  
当前为**已发布正式版**（`/flow/*`，对外可调用）。

YAML`http://node_site_upstream/openapi/workflow/6a97b9f33c51f24167049bdc.yaml`

[浏览器查看 YAML](http://node_site_upstream/openapi/workflow/6a97b9f33c51f24167049bdc.yaml) [下载 YAML](http://node_site_upstream/openapi/workflow/6a97b9f33c51f24167049bdc.yaml?download=1)

JSON`http://node_site_upstream/openapi/workflow/6a97b9f33c51f24167049bdc.json`

[浏览器查看 JSON](http://node_site_upstream/openapi/workflow/6a97b9f33c51f24167049bdc.json) [下载 JSON](http://node_site_upstream/openapi/workflow/6a97b9f33c51f24167049bdc.json?download=1)

介绍

在线运行

Skill与API