本接口采用异步任务模式，提交请求后返回 `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-1?appKey={your_appKey}查看密钥调用帮助

返回格式JSON

请求方式POST

请求参数

Header 参数

请求 Body 体

body

{
    "prompt": "a cute cat",//生成图片描述词 支持中文（必选）
  	"aspect_ratio":"9:16", //  可选值：1:1, 3:4, 4:3, 16:9, 9:16
  	"referImages": [""]//引用图片URL或base64，支持多张图
}

返回参数

该接口返回经 showapi_res_body 系统封装，业务数据均位于该对象内；系统级字段见。

返回体

请求示例

查看我的 appKey 查看使用向导

Python / Java 等多语言示例

cURL

curl -X POST "https://route.showapi.com/3599-1?appKey=YOUR_APPKEY" \
  -H "content-type: application/json" \
  -d '{
    "prompt": "a cute cat",//生成图片描述词 支持中文（必选）
  	"aspect_ratio":"9:16", //  可选值：1:1, 3:4, 4:3, 16:9, 9:16
  	"referImages": [""]//引用图片URL或base64，支持多张图
}'

返回示例

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 管理）。该服务覆盖本接口全部接入点。

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

下载 YAML

查看 JSON

生图编辑图服务

常见问题

相关协议

API大全

关于我们

联系我们