> **平台**: 万维易源 (ShowAPI)
> **接入方式**: 统一 API 网关 (HTTPS POST/GET)
> **认证**: showapi_appid + showapi_sign
> **文档**: https://www.showapi.com/apiGateway/view/3599/2
---
title: "Image图像生成_上传文件 - 生图编辑图服务|万维易源ShowAPI"
canonical_url: "https://www.showapi.com/apiGateway/view/3599/2"
last_updated: "2026-09-21T14:36:42.450Z"
meta:
description: "本接口采用异步任务模式，提交请求后返回 `task_id` 与初始任务状态。建议根据返回的 `task_status` 进行轮询，或在万维易源控制台查看任务最终状态。当 `task_status` 为 `SUCCEEDED` 时，可通过 `result_url` 获取最终生成的图像；若为 `FAILED`，请根据系统错误码排查后重新提交。
注意事项：
1. 系统已**内置最优高清图像生成模型**，无需用户传入模型参数，由接口自动匹配对应模型；
2. `aspect_ratio` 可选值为：`1:1`、`3:4`、`4:3`、`16:9`、`9:16`；
3. `referImages` 为引用图片 URL 数组，支持传入多张参考图；
4. 请求地址中的 `{your_appKey}` 需替换为真实的 AppKey；
5. 图像生成为异步执行，提交成功后请妥善保存返回的 `task_id`，用于后续查询任务状态及获取结果。"
keywords: "api接口,api接口大全,免费api,免费数据接口,数据接口,api开放平台,万维易源,showapi,大模型,AI Skills"
"og:description": "本接口采用异步任务模式，提交请求后返回 `task_id` 与初始任务状态。建议根据返回的 `task_status` 进行轮询，或在万维易源控制台查看任务最终状态。当 `task_status` 为 `SUCCEEDED` 时，可通过 `result_url` 获取最终生成的图像；若为 `FAILED`，请根据系统错误码排查后重新提交。
注意事项：
1. 系统已**内置最优高清图像生成模型**，无需用户传入模型参数，由接口自动匹配对应模型；
2. `aspect_ratio` 可选值为：`1:1`、`3:4`、`4:3`、`16:9`、`9:16`；
3. `referImages` 为引用图片 URL 数组，支持传入多张参考图；
4. 请求地址中的 `{your_appKey}` 需替换为真实的 AppKey；
5. 图像生成为异步执行，提交成功后请妥善保存返回的 `task_id`，用于后续查询任务状态及获取结果。"
"og:title": "API 市场|万维易源ShowAPI"
---
*
*
*
# **生图编辑图服务**
**官方自营**
Generate images based on text prompts and image resources
已选规格
￥**10.00**元
自购买起有效期 12 个月
专用资源包10.00元 200.00元 查看全部规格 ›
支持****通用资源包****：充值通用资源包后可直接调用含本接口在内的全站付费接口，无需单独购买专用资源包 [**去充值 ›**](https://www.showapi.com/ai/llm/recharge)
在线调试 立即购买
**官方自营**
易源官方提供，长期稳定运营
- 服务商
- 昆明秀派科技有限公司
- 电话
- 400-998-8033
- QQ
- 4009988033
- 邮箱
- [service@showapi.com](mailto:service@showapi.com)
- 所属分类
- AI大模型
- 接入点
- 3 个
- 请求方式
- POST
- 返回格式
- JSON
**Image图像生成\_上传文件**
接入点说明
```
本接口采用异步任务模式，提交请求后返回 `task_id` 与初始任务状态。建议根据返回的 `task_status` 进行轮询，或在万维易源控制台查看任务最终状态。当 `task_status` 为 `SUCCEEDED` 时，可通过 `result_url` 获取最终生成的图像；若为 `FAILED`，请根据系统错误码排查后重新提交。
注意事项：
1. 系统已**内置最优高清图像生成模型**，无需用户传入模型参数，由接口自动匹配对应模型；
2. `aspect_ratio` 可选值为：`1:1`、`3:4`、`4:3`、`16:9`、`9:16`；
3. `referImages` 为引用图片 URL 数组，支持传入多张参考图；
4. 请求地址中的 `{your_appKey}` 需替换为真实的 AppKey；
5. 图像生成为异步执行，提交成功后请妥善保存返回的 `task_id`，用于后续查询任务状态及获取结果。
```
接口地址
https://route.showapi.com/3599-2?appKey={your\_appKey} [查看密钥](https://www.showapi.com/console#/myApp) [调用帮助](https://www.showapi.com/helpcenter/view#/3960/1)
返回格式JSON
请求方式POST
**请求参数**
**Header 参数**
| |
|
| |
|
**Post 表单**
| |
|
| |
|
| |
| |
**返回参数**查看公共返回参数
该接口返回经 `showapi_res_body` 系统封装，业务数据均位于该对象内；系统级字段见公共返回参数。
**返回体**
| |
|
| |
|
| |
| |
| |
| |
**请求示例**
[查看我的 appKey](https://www.showapi.com/console#/myApp) [查看使用向导](https://www.showapi.com/helpcenter/view#/3960/1) [Python / Java 等多语言示例](https://www.showapi.com/apitest/market/3599/2)
cURL 复制
```
curl -X POST "https://route.showapi.com/3599-2?appKey=YOUR_APPKEY" \
-H "content-type: multipart/form-data" \
-d "prompt=&aspect_ratio=&images.N="
```
**返回示例**
JSON 复制
```
{
"showapi_res_id": "",
"showapi_res_error": "",
"showapi_res_code": 0,
"showapi_res_body": {
"task_id": "ecd631bac3fa4f16a02385305c6ea717",
"task_status": "SUCCEEDED",
"result_url": "https://promptimg.showapi.com/tasks/ecd631bac3fa4f16a02385305c6ea717.png",
"ret_code": 0
}
}
```
**MCP 服务集成**接口级
在 Cherry Studio、ChatBox 等支持 MCP 的客户端中配置，将 {your\_appKey} 替换为真实 AppKey（ [AppKey 管理](https://www.showapi.com/console#/myApp)）。该服务覆盖本接口全部接入点。
MCP JSON 复制
```
{
"mcpServers": {
"showapi-mcp-3599": {
"url": "http://www.showapi.com.cn/mcp/3599/{your_appKey}"
}
}
}
```
**OpenAPI 文档**接口级
标准 OpenAPI 3.0 文档，覆盖本接口全部接入点，可导入 Apifox / Postman / Swagger UI，或供 AI Agent 直接消费。
[在线查看 YAML](https://www.showapi.com/openapi/market/3599.yaml) [下载 YAML](https://www.showapi.com/openapi/market/3599.yaml) [查看 JSON](https://www.showapi.com/openapi/market/3599.json)