API 能力说明

图像能力 API 平台

将图片生成、图片编辑、局部编辑、模板生成等能力封装为统一服务，供业务系统按任务方式调用。当前已保留 route handler、service 层与结构化响应，后续可继续扩展模型、存储和业务配额。

图片生成 API

统一鉴权、任务 id、状态查询、结果数组与错误处理，便于接入不同业务页面。

图片编辑 API

统一鉴权、任务 id、状态查询、结果数组与错误处理，便于接入不同业务页面。

局部编辑 API

统一鉴权、任务 id、状态查询、结果数组与错误处理，便于接入不同业务页面。

商品图 API

统一鉴权、任务 id、状态查询、结果数组与错误处理，便于接入不同业务页面。

海报生成 API

统一鉴权、任务 id、状态查询、结果数组与错误处理，便于接入不同业务页面。

任务查询 API

统一鉴权、任务 id、状态查询、结果数组与错误处理，便于接入不同业务页面。

调用流程

从业务请求到图片结果

业务系统

API Gateway

任务编排

图像模型

对象存储

返回结果

调用示例

POST /api/images/edit
Content-Type: application/json

{
  "imageUrl": "https://images.unsplash.com/photo-1541643600914-78b084683601?auto=format&fit=crop&w=1000&h=1000&q=82",
  "prompt": "把背景换成干净的白色摄影棚，主体保持不变",
  "tool": "background"
}

Response
{
  "taskId": "task-id",
  "status": "succeeded",
  "results": [
    {
      "id": "result-1",
      "url": "https://images.unsplash.com/photo-1522335789203-aabd1fc54bc9?auto=format&fit=crop&w=1000&h=1000&q=82",
      "type": "edited",
      "label": "效果图 1"
    }
  ]
}