GPU API工具箱 API 文档Proxy Base URL（画布内部）图片类
图片类
GPU API 图片工具箱完整接口、输入顺序、工作流与调用方式
图片类工具箱
本页描述画布和图片工作台使用的 Proxy API。Base URL 为 https://ic.xshow.live/api/proxy/v1，依赖登录 Cookie 和 X-IC-Operation-ID。无参考图文生图使用 /images/generations/tasks；参考图编辑使用 /images/edits/tasks。
XCamShow/B 端使用独立的 Partner 图片 API，Base URL 为 https://ic.xshow.live/api/partner/v1，使用 Bearer Key 和 Idempotency-Key，不使用浏览器 Cookie。
文生图与明星模型
能力矩阵
| 功能 | model | 图片输入 | 执行流程 | 类型 |
|---|---|---|---|---|
| Krea2 文生图 | krea2 | 无 | 提示词 → GPU 生图 | 文生图 |
| 明星生图 / 编辑 | krea2-girlslike-{alias} | 0 或 1 图 | 模型 ID 固定身份 → GPU 生图 / 编辑 | 文生图 / 编辑 |
| 头像裁切 | 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 恢复。