Partner API 总览（v4）

Base URL: https://ic.xshow.live/api/partner/v1
Authorization: Bearer <PARTNER_API_KEY>
Create idempotency: Idempotency-Key

查看版本归档。当前文档为 v4；历史 v1、v2、v3 原文独立保留。

查看 xyz/live 工具箱实际调用：区分 XCamShow 浏览器入口、Partner 请求及视频换脸的独立 Scheduler 历史接口。当前工具箱的视频换脸已改走 Partner。

Partner API 只允许后端服务器调用。API Key 不进入浏览器、URL、客户端日志或代码仓库。网络重试必须复用原 Idempotency-Key；创建不同任务时使用新值。

当前资源族

Partner 当前开放 9 个业务能力：图片 4 个、视频 5 个。任务查询、下载、取消属于同一能力的生命周期路由，不另计为业务能力；模板模式是已有视频模型的输入模式，不另计模型。

图片查询使用 /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"

三个工具箱视频模型 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 节点或工作流文件名。