XCamShow 工具箱实际调用
xyz 与 live 工具箱的浏览器入口、Partner 请求与历史 Scheduler 边界
XCamShow 工具箱实际调用
本页记录 XCamShow 6be7136d1383340c7307b1bb9472008a3afec77f 在 xyz 测试站 与 live 正式站 的运行配置和代码路径，不是 Partner API 所有可用模型的清单。两站的前端、管理端、后端镜像摘要相同；下表中不同的上游地址来自各环境独立配置。
| 环境 | 图片与视频 Partner Base URL | 历史 Scheduler Base URL（本次视频换脸不调用） |
|---|---|---|
| xyz 测试 | https://ic.xshow.live/api/partner/v1 | http://infinite-canvas-scheduler-1:8020 |
| live 正式 | http://canvas-web:3000/api/partner/v1 | http://scheduler:8020 |
live 表中的 HTTP 主机名只在容器网络内使用，不是浏览器地址。两边后端均已配置 Partner Key；密钥只留在服务端。浏览器始终请求各自 XCamShow 域名下的同源 /api/...，不会直接调用上述上游。
当前工具箱目录中的五个工具
| 工具 | 浏览器提交到 XCamShow | 后端实际创建请求 | 是否经过 Partner |
|---|---|---|---|
| 图片脱衣 | POST /api/undress | POST {Partner Base URL}/images/edits，model=image-undress | 是 |
| 图片换脸 | POST /api/faceswap | POST {Partner Base URL}/images/edits，model=head-swap-bfs | 是 |
| 视频姿势 | POST /api/pose-video | POST {Partner Base URL}/videos，model=video-pose | 是 |
| 视频脱衣 | POST /api/video-swap，mode=video_undress | POST {Partner Base URL}/videos，model=video-undress | 是 |
| 视频换脸 | 上传身份图到 /api/upload 后，POST /api/video-swap，mode=video_faceswap，附 video_template | POST {Partner Base URL}/videos，model=video-face-swap，只传身份图与受控 template_id | 是 |
例如视频脱衣在 xyz 的创建请求落到 https://ic.xshow.live/api/partner/v1/videos，在 live 落到容器内的 http://canvas-web:3000/api/partner/v1/videos；公开模型名均为 video-undress。图片类同理使用各自 Base URL 的 /images/edits。
**三个视频工具的执行链：**XCamShow 后端均提交公开 Partner 模型，不自行选择 GPU 或 Wan3.0。画布按工具型号与订单 ID 稳定散列，约半数优先旧 GPU 工作流，约半数走 Wan3.0；优先 GPU 的订单先检查容量，再由 Scheduler 原子准入。只有明确返回 409 gpu_not_immediately_available 且原 GPU 任务已持久取消，才用同一订单改走 Wan3.0；超时或不明确错误不触发第二次提交。换脸的 GPU 分支复用 LTX 2.5，脱衣复用 SCAIL2，姿势复用现有 MiniMax 工作流；姿势云端分支先由 Qwen3 Image Pro 编辑图片，再交给 Wan3.0。换脸模板由美国 spicy-cc-us 受控字典解析，上传视频与模板源都只处理前 10 秒。旧独立 Scheduler 同名接口和画布 Spicy 路由保持不变。详见当前 Partner 视频合同。
任务状态也由 XCamShow 浏览器查询同源 API：图片工具分别查询自身 /api/.../{taskId}，视频姿势查询 /api/pose-video/{taskId}，视频换脸/脱衣查询 /api/video-swap/{taskId}。后端再按实际提供方轮询 Partner 图片 POST /images/{id}、Partner 视频 POST /videos/{id}（必要时按兼容模式读取）。媒体结果由 XCamShow 后端读取并保存，浏览器不持有 Partner 凭据。
若以后重新部署 XCamShow 或调整其运行配置，应重查两站的容器 SHA、Partner Base URL、模板桶及当前目录中的工具，随后更新本页；不要把本页的部署快照当成永久固定路由。