change_cloth/API.md

change_app.py API 文档

1. GET /

返回主页静态文件 index.html。

---

2. POST /change_cloth

推荐入口，带 Redis 队列排队，避免并发冲突。

请求参数（JSON）

参数	类型	必选	说明
human_url	string	是	人物图片 URL
cloth_url	string	是	服装图片 URL
output_format	string	是	输出格式，包含 "base64" 则返回 base64，否则返回 URL
no2	bool	否	true=跳过第一步（脱衣/生成写真），直接换衣；默认 false
tuodi	bool	否	true=使用拖地款工作流；默认 false
kuzi	bool	否	是否同时换裤子（配合 kuzi_url）；默认 false
cloth_len	string	否	手动指定服装长度（如"膝盖""拖地"等），不传则 AI 自动判断
suit	bool	否	true=使用 Gemini 模型换装（套装模式）；默认 false

响应

// 成功（URL 模式）
{
  "ret": 0,
  "state": 0,
  "msg": "success",
  "url": "https://xiangsilian.oss-cn-beijing.aliyuncs.com/xxx.jpg",
  "second_url": "换衣前中间步骤图 URL",
  "first_url": "第一步（脱衣/写真）图 URL",
  "is_girl": true
}

// 成功（base64 模式）
{
  "ret": 0,
  "state": 0,
  "msg": "success",
  "data": "data:image/jpeg;base64,...",
  "second_step_data": "...",
  "first_step_data": "...",
  "is_girl": true
}

// 失败
{ "ret": -1, "state": -1, "msg": "错误信息" }

---

3. POST /change_cloth_base64

与 /change_cloth 功能相同，图片以 Base64 格式传入。

请求参数（JSON）

参数	类型	必选	说明
human_img	string	是	人物图片 base64（带 data: 头，如 data:image/jpeg;base64,...）
cloth_img	string	是	服装图片 base64
output_format	string	是	同上
kuzi_img	string	否	裤子图片 base64
no2	bool	否	同上
tuodi	bool	否	同上
suit	bool	否	同上
cloth_len	string	否	同上

响应

同 /change_cloth。

---

4. POST /do_change_cloth

直接调用，无队列保护，通常由内部或 /change_cloth_base64 调用，不建议外部直接使用。

请求参数（JSON）

参数	类型	必选	说明
human_url	string	是	人物图片 URL
cloth_url	string	是	服装图片 URL
output_format	string	是	同上
no2	bool	否	同上
tuodi	bool	否	同上
kuzi_url	string	否	裤子图片 URL
cloth_len	string	否	同上
suit	bool	否	同上

响应

同 /change_cloth。

---

备注

• cloth_len 可选值：胸、腰、跨、大腿、膝盖、小腿、脚踝、拖地、裤子、难以辨认
• 若服装图片中检测到人物，cloth_len 自动设为 拖地
• 结果图片同时上传至阿里云 OSS（bucket: xiangsilian，region: 北京）
• 服务默认监听端口由 config.py 中的 base64_test_port 决定