GPU API
GPU API
面向画布、工作台、Partner 与 GPU 运维人员的接口入口和快速选择指南
GPU API 统一承载图片、视频、工具箱和 GPU 调度能力。请先按调用方选择入口；业务调用方不需要理解 ComfyUI 节点、GPU 地址或内部工作流文件。
选择调用入口
INFINITE CANVAS
Proxy API（画布内部）
适用于画布节点、生图工作台和视频工作台。使用登录 Cookie，由平台处理权限、积分与任务归属。
XCamShow / B 端
Partner API
适用于服务器到服务器调用。使用 Partner API Key 和幂等键，不复用浏览器登录态。
| 对比项 | Proxy API | Partner API |
|---|---|---|
| 调用方 | 画布、图片/视频工作台 | XCamShow、B 端服务器 |
| Base URL | https://ic.xshow.live/api/proxy/v1 | 见 Partner Base URL 页面 |
| 鉴权 | Infinite Canvas 登录 Cookie | Authorization: Bearer <API_KEY> |
| 幂等 | X-IC-Operation-ID | Partner 幂等键 |
| 计费归属 | 当前平台用户 | Partner 账户/租户 |
能力地图
标准任务流程
- 发现能力：读取模型目录并检查
ready，不可用时展示missing原因。 - 创建任务：携带新的幂等 operation ID，图片编辑和视频统一使用
multipart/form-data。 - 查询状态：使用创建响应中的平台任务 ID，不直接访问 GPU 或供应商任务地址。
- 读取结果：通过平台 content 接口读取并完成媒体校验与积分结算。
- 失败恢复：客户端超时或
5xx不代表任务未执行，应使用原 operation ID 恢复，不能盲目重复扣费。
快速入口
| 你要完成的事情 | 文档入口 |
|---|---|
| Krea2 无参考图文生图 | Krea2 文生图 |
| 明星系列生图与单图编辑 | 明星 Krea2 |
| 在画布中调用图片/视频工具 | Proxy API 总览 |
| 接入 MiniMax H3 原版及 DaSiWa 五模式 | MiniMax H3 |
| 从 XCamShow/B 端调用七项工具箱能力 | Partner API 总览 |
| 查看图片工具箱 | Proxy 图片 / Partner 图片 |
| 查看视频工具箱 | Proxy 视频 / Partner 视频 |
| 查看模型、Scheduler、显存与生产验收 | 技术参考与验收档案 |
| 查看统一错误响应和任务事件 | API 响应约定 |
边界说明
- 前端和 Partner 调用只使用公开模型 ID，不提交 GPU 地址、LoRA 文件路径、ComfyUI 节点 ID或内部 Token。
/live仅代表进程存活；模型是否可用以模型目录的ready和真实 canary 为准。- HTTP 成功、文件存在或媒体可解码只代表链路成功；图片和视频最终上线仍需视觉质量验收。
- 性能、显存、工作流 SHA、任务样本及历史回归记录统一放在技术档案，不再占用接入总览。
GPU 监控数据口径
- 硬件指标由 GPU 主机上的
nvidia-smi通过受限只读 SSH 命令采集，10 秒更新，超过 30 秒的快照失效；不支持的风扇等传感器返回null，不伪造 0。 - 每个 ComfyUI 实例的
/queue独立读取运行和等待数量。平台 Scheduler 任务库的运行/等待数量与 ComfyUI 原生队列分别展示；直接提交给 ComfyUI 的任务不计入平台任务总数。 - 平台已归属任务仅展示工作流名称与聚合数量；原生队列不暴露 prompt、任务 ID、素材或用户凭据。GPU 利用率可能来自非 ComfyUI 进程，不等于任务数。
GET /v1/gpus的每实例hardware与comfy_queue为可空快照；Proxy/v1/scheduler/status白名单校验后提供给画布。采样失败或过期时保持未知，而不是沿用旧值。