Partner API 总览
XCamShow 与 B 端服务器使用 API Key 调用的对外接口
Partner API 总览（v4）
Base URL: https://ic.xshow.live/api/partner/v1
Authorization: Bearer <PARTNER_API_KEY>
Create idempotency: Idempotency-Key
Create attribution: Xcamshow-Uid: <XCamShow 用户 ID>查看版本归档。当前文档为 v4；历史 v1、v2、v3 原文独立保留。
查看 xyz/live 工具箱实际调用：区分 XCamShow 浏览器入口、Partner 请求及视频换脸的独立 Scheduler 历史接口。当前工具箱的视频换脸已改走 Partner。
Partner API 只允许后端服务器调用。API Key 不进入浏览器、URL、客户端日志或代码仓库。网络重试必须复用原 Idempotency-Key；创建不同任务时使用新值。
当前资源族
Partner 当前 Web 路由白名单识别 11 个公开模型：图片 4 个、视频 7 个。生产 Proxy 只读模型列表显示其中 DreamID-V 与视频换脸 v2 当前 ready=false，因此不能把“路由接受模型名”理解成“可以完成生成”；其余模型也仍须以实际请求与供应商状态为准。任务查询、下载、取消属于同一模型的生命周期路由；模板模式是已有视频模型的输入模式。
| 资源 | 创建 | 当前模型 |
|---|---|---|
| 图片编辑 | 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；另有已识别但当前未就绪的 video-face-swap-dreamid、video-face-swap-v2 |
图片查询使用 /images/{id}，视频查询使用 /videos/{id}；读取、取消和中间结果继续挂在对应任务路径下。先阅读鉴权、任务状态与错误处理，再按功能阅读独立参考页：
| 图片功能 | 视频功能 |
|---|---|
| 图片脱衣 | 视频换脸 |
| 图片姿势切换 | 视频换人 |
| BFS 自动换头 | 视频编辑 |
| Klein 精准换头 | Spicy 视频换脸 |
| 视频姿势 | |
| DreamID-V 视频换脸（当前未就绪） | |
| 视频换脸 v2 智能选路（当前未就绪） |
curl -X POST "https://ic.xshow.live/api/partner/v1/videos" \
-H "Authorization: Bearer $PARTNER_API_KEY" \
-H "Idempotency-Key: $ORDER_ID" \
-H "Xcamshow-Uid: $XCAMSHOW_UID" \
-F "model=video-pose" \
-F "input_reference[]=@person.png;type=image/png" \
-F "prompt=保持人物身份并调整为目标姿势" \
-F "lora=krea2/sex/POSE.safetensors"三个工具箱视频模型 video-face-swap、video-undress、video-pose 按模型与业务订单 ID 稳定散列：约半数优先原 GPU 工作流，约半数走 Wan3.0；GPU 优先订单的调度器快照无可立即使用的空闲卡时走 Wan3.0。姿势云端分支先用 qwen-image-3.0-pro 编辑姿势图，再用 Wan3.0 I2V。换脸模板或上传源视频仍由服务端只取前 10 秒；独立 video-head-swap-spicy 保持原 Wan3.0 合同。
Partner API 不接受画布 Cookie，也不暴露内部 Proxy/Scheduler 凭据、GPU 节点或工作流文件名。