文档更新时间：2026年09月08日 12时53分18秒（UTC+8）

图片类工具箱

最后更新：2026-09-07

本页描述画布和图片工作台使用的 Proxy API。Base URL 为 https://ic.xshow.live/api/proxy/v1，依赖登录 Cookie 和 X-IC-Operation-ID。所有图片工具均通过异步图片编辑入口提交。

XCamShow/B 端使用独立的 Partner 图片编辑 API，Base URL 为 https://ic.xshow.live/api/partner/v1，使用 Bearer Key 和 Idempotency-Key，不使用浏览器 Cookie。

能力矩阵

功能	model	图片输入	执行流程	类型
头像裁切	`avatar`	图1人物图	YOLOv8 人脸定位 → 512×512 居中裁切	图片工具
经典图片换脸	`comfy-faceswap`	图1目标底图；图2人脸来源	FaceSwap → 输出	单工作流
FLUX.2 Klein 精准换脸	`face-swap`	图1目标底图；图2身份来源	Klein 换脸 → SeedVR2	单工作流
FLUX.2 Klein 精准换脸 Pro	`face-swap-pro`	图1目标底图；图2身份来源	Klein 换脸 → Krea2 局部融合 → SeedVR2	多阶段工作流
FLUX.2 Klein 精准换头	`head-swap`	图1目标底图；图2头部身份来源	Klein 换头 → SeedVR2	单工作流
FLUX.2 Klein 精准换头 Pro	`head-swap-pro`	图1目标底图；图2头部身份来源	Klein 换头 → Krea2 局部融合 → SeedVR2	多阶段工作流
Krea2 Turbo v2.5 图像编辑	`krea2-turbo-v25-edit`	图1待编辑原图	原图 + 提示词 + 可选 LoRA Stack → 编辑结果	图像编辑工作流
画布姿势图片编辑	`krea2-turbo-v25-edit` + `toolsbox_pose_lora`	图1待编辑原图	原图 + 提示词 + `krea2/sex/*` LoRA → 编辑结果	Proxy 姿势接口
图片脱衣	`muse-v35-undress`	图1目标图；图2可选身份/身体参考	Krea2 编辑链 → 输出	单工作流
BFS 换头	`krea2-bfs-v1`	图1目标底图；图2头部身份	BFS Head Swap	单工作流
BFS 换身体	`krea2-bodyswap-v1`	图1目标底图；图2身体身份	BodySwap	单工作流
图片超分	`seedvr2-upscale`	图1待放大图片	SeedVR2 4×	单工作流
图片换人（单阶段）	`krea2-identity-edit`	必填 prompt；图1场景底图；图2人物身份	Krea2 Identity Edit	单工作流
图片换人（BFS 双阶段）	`krea2-person-swap-v1`	必填 prompt；图1场景底图；图2人物身份	BFS 换头 → BodySwap 换身体	组合 API

标准异步请求

curl -X POST "$BASE_URL/api/proxy/v1/images/edits/tasks" \
  -H "Cookie: ic_session=$IC_SESSION" \
  -H "X-IC-Operation-ID: $(uuidgen)" \
  -F "model=face-swap" \
  -F "prompt=自然融合身份并保持底图构图" \
  -F "image=@target.png" \
  -F "image=@identity.png"

同名 image 字段的出现顺序即图片1、图片2，每个 part 必须声明真实 image/* MIME，不能使用 application/octet-stream。成功后轮询：

curl -X POST -H "Cookie: ic_session=$IC_SESSION" "$BASE_URL/api/proxy/v1/images/tasks/$TASK_ID"
curl -L -H "Cookie: ic_session=$IC_SESSION" "$BASE_URL/api/proxy/v1/images/tasks/$TASK_ID/content?index=0" -o result.png

校验与错误

图片必须是可解码媒体；错误页、JSON、空文件不会作为成功结果。
image_output_local_black_collapse 表示输出因大面积局部黑块被质量校验拒绝；应排查工作流或输入组合。
两图模型少于或多于 2 张返回 400；头像裁切和超分必须恰好 1 张；脱衣允许 1–2 张。
503 表示模型或 GPU 路由当前不可用；先读取 /api/proxy/v1/models?refresh=true 的 ready/missing。
客户端取消只在服务端确认后释放预扣；结果不确定时保留 unknown 并用原 operation ID 恢复。

图片类

图片类工具箱

能力矩阵

标准异步请求

校验与错误

On this page