工具箱 API 总览

最后更新：2026-09-08

工具箱提供两套用途、鉴权和 Base URL 均不同的 API。画布与工作台使用 Proxy API；XCamShow 和 B 端服务器使用 Partner API。两者最终可以复用同一 GPU 工作流，但客户端不得混用入口或凭据。

GPU API → 工具箱 API → 图片类
GPU API → 工具箱 API → 视频类

先选择正确的 Base URL

接口族	调用方	Base URL	鉴权	创建幂等
Proxy API	Infinite Canvas 浏览器、画布、生图/视频工作台	`https://ic.xshow.live/api/proxy/v1`	登录 Cookie	`X-IC-Operation-ID`
Partner API	XCamShow、B 端后端服务	`https://ic.xshow.live/api/partner/v1`	`Authorization: Bearer ...`	`Idempotency-Key`

/api/proxy/v1 不是提供给 B 端的 API Key 接口；/api/partner/v1 也不是画布浏览器接口。任何客户端都不直接调用 Scheduler、GPU 主机或 ComfyUI。

路径对照

能力	Proxy API（画布）	Partner API（XCamShow/B 端）
图片编辑创建	`POST /images/edits/tasks`	`POST /images/edits`
图片任务查询	`POST /images/tasks/{id}`	`POST /images/{id}`
图片结果读取	`GET /images/tasks/{id}/content?index=0`	`GET /images/{id}/content`
视频任务创建	`POST /videos`	`POST /videos`
视频任务查询	`POST /videos/{id}`	`POST /videos/{id}`
视频中间帧	`GET /videos/{id}/intermediate`	`GET /videos/{id}/intermediate`
视频结果读取	`GET /videos/{id}/content`	`GET /videos/{id}/content`

统一请求规则

Proxy 浏览器请求自动携带登录会话；命令行测试使用 Cookie: ic_session=$IC_SESSION。创建任务使用唯一的 X-IC-Operation-ID。
Partner 请求只在服务器端发送 Bearer Key；每次创建使用 Idempotency-Key，网络重试复用原值。
图片编辑以重复的 image multipart 字段保持图片顺序。
图片 part 必须声明真实 image/* MIME；视频 part 必须声明 video/mp4 或 video/quicktime，不得使用 application/octet-stream 代替。视频组合接口以 input_reference[] 提交人物图片和源视频；图片排在视频前后均可，Proxy 按 MIME 分类并校验数量。
/videos 即使没有上传文件也只接受 multipart，纯文生视频不得改用 JSON 或 urlencoded。
创建成功返回任务 id；轮询到 completed 后再读取 content。
相同 operation ID 用于断线恢复，重新生成必须使用新的 operation ID。

通用任务状态

{
  "id": "task_xxx",
  "status": "pending",
  "compute": {
    "kind": "scheduler",
    "phase": "queued",
    "endpoint": "face-swap",
    "gpu_model": null,
    "vram_required_mb": null
  }
}

pending/running 继续轮询，completed 读取媒体，failed 展示服务端 error.message 和 code。取消使用对应的 POST .../tasks/{id}/cancel 或 POST .../videos/{id}/cancel。

工具箱 API 总览

工具箱 API 总览

先选择正确的 Base URL

路径对照

统一请求规则

分类

通用任务状态

On this page