GPU API工具箱 API 文档Partner API版本归档v3 历史文档
Partner API 总览
XCamShow 与 B 端服务器使用 API Key 调用的对外接口
Partner API 总览（v3）
Base URL: https://ic.xshow.live/api/partner/v1
Authorization: Bearer <PARTNER_API_KEY>
Create idempotency: Idempotency-Key查看版本归档。当前文档为 v3；历史 v1、v2 原文独立保留。
查看 xyz/live 工具箱实际调用：区分 XCamShow 浏览器入口、Partner 请求及视频换脸的独立 Scheduler 历史接口。当前工具箱的视频换脸已改走 Partner。
Partner API 只允许后端服务器调用。API Key 不进入浏览器、URL、客户端日志或代码仓库。网络重试必须复用原 Idempotency-Key；创建不同任务时使用新值。
当前资源族
Partner 当前开放 9 个业务能力：图片 4 个、视频 5 个。任务查询、下载、取消属于同一能力的生命周期路由，不另计为业务能力；模板模式是已有视频模型的输入模式，不另计模型。
| 资源 | 创建 | 当前模型 |
|---|---|---|
| 图片编辑 | POST /images/edits | image-undress、image-pose、head-swap-bfs、head-swap |
| 视频生成 | POST /videos | video-face-swap、video-person-swap、video-undress、video-head-swap-spicy、video-pose |
图片查询使用 /images/{id}，视频查询使用 /videos/{id}；读取、取消和中间结果继续挂在对应任务路径下。完整字段见 Partner 图片 API 和 Partner 视频 API。
curl -X POST "https://ic.xshow.live/api/partner/v1/videos" \
-H "Authorization: Bearer $PARTNER_API_KEY" \
-H "Idempotency-Key: $ORDER_ID" \
-F "model=video-pose" \
-F "input_reference[]=@person.png;type=image/png" \
-F "prompt=保持人物身份并调整为目标姿势" \
-F "lora=krea2/sex/POSE.safetensors"视频换脸的公开 model=video-face-swap 在画布侧改写为 video-head-swap-spicy，模板 ID 由服务端受控字典解析，模板或上传源视频都只取前 10 秒，再通过画布内部 /v1/video-head-swap-spicy 路由执行 Wan3.0；视频脱衣仍改写为 wan3.0-video。video-pose 的图片阶段结束后统一使用 Wan3.0 I2V。
Partner API 不接受画布 Cookie，也不暴露内部 Proxy/Scheduler 凭据、GPU 节点或工作流文件名。