灵构 API 最佳实践 · 可运行 Cookbook

覆盖典型流程(Create → Poll → Start/Stop → Scene URL → Image),提供可复制的 curl/fetch 请求。

更新日期:2025-11-11 · 版本:2025-11-11
使用须知 ApiKey 不会持久化;建议本机离线+本地静态服务打开(避免 file:// 和 CORS)。如被拦截,请使用同域反向代理。

无影灵构 工作站API 说明

配置与执行

请求实际会构造为:endpoint?Action=XXX&Format=JSON&Version=2025-11-11...
ApiKey 放置策略: Body(推荐) Query(兼容)

场景1:创建实例 → 获取 ComfyUi URL

推荐主流程:GetProductList → CreateOrder → DescribeDesktops 轮询 →(必要时 StartDesktop)→ GenerateWuyingServerSceneUrl。

步骤 1:GetProductList(获取可部署规格)
示例:linggou_postpaid_container / linggou_core_package
请求代码(可复制)

          
响应(原文)

          
自动提取:(尚未提取)
步骤 1.5(可选):根据镜像码获取 ImageId
请求代码(可复制)

          
响应(原文/JSON)

          
自动提取:ImageId=-(将填充到 CreateOrder 的 ImageId)
步骤 2:CreateOrder(创建并部署实例)
请求代码(可复制)

          
响应(原文)

          
自动提取:OrderId=-;InstanceId=-
步骤 3:DescribeDesktops(轮询实例状态)实例 Running 后再进行后续步骤
当前状态:- ManagementFlag:- Last Update:-
请求代码(可复制)

          
响应(原文)

          
步骤 4:GenerateWuyingServerSceneUrl(获取 ComfyUi URL)
URL:- ExpireTime:-
请求代码(可复制)

          
响应(原文)

          
步骤 5:DeleteDesktop(销毁实例,可选)
请求代码(可复制)

          
响应(原文)

          
提示:DeleteDesktop 不可逆,建议先确认实例已不再需要。

场景2:生命周期管理(安全执行模式)

建议模式:操作前 DescribeDesktops 获取状态 → 状态满足再 Start/Stop/Delete → 操作后再次 DescribeDesktops 验证。

步骤 A:DescribeDesktops(查询当前状态)
请求代码

          
响应(原文)

          
提示:从响应中复制 DesktopId 到下方操作步骤。
步骤 B:StartDesktop / StopDesktop / DeleteDesktop
请求代码

          
响应(原文)

          
Delete 不可逆;建议先 Stop 再 Delete(若你们业务要求)。

场景3:制作镜像(Stopped → CreateDesktopImage → 轮询 Available)

步骤 1:确保实例为 Stopped(必要时 StopDesktop + 轮询 DescribeDesktops)
请求代码

          
响应(原文)

          
步骤 2:CreateDesktopImage(创建镜像)
请求代码

          
响应(原文)

          
自动提取:ImageId=-
步骤 3:DescribeImageDetail(轮询镜像到 Available)
Status:- Progress:- Last Update:-
请求代码

          
响应(原文)

          

场景4:余额 / 订单核对(排障闭环)

步骤 1:DescribeCorePackageList(核时余额与抵扣实例)
请求代码

          
响应(原文)

          
步骤 2:DescribePackageOrders(查询订单)
请求代码

          
响应(原文)