文档中心

智能视觉服务

交付中心

一键部署

一键部署详细操作步骤

炉米房间新建或导入工作流

https://console.volcengine.com/lumi/home/ai_capability

workflow 参数定义（开槽）

参数定义也就是常说的「开槽」，这里是明确 workflow 中的哪些节点被开放，将 ComfyUI 工作流中的参数暴露为算法服务 API 中的参数信息，未被「开槽」的节点参数将统一封装。

常见开槽参数：

loadimage+saveimage：上传图、输出结果图

ksample：

denoise

seed

prompt: 跟设计师确认具体开槽节点

这意味着在后续的 API 接入中：

以上参数会显示默认值，并可以被调整

实际部署中仅需根据业务需求开放对应参数即可，「一键部署」功能提供自动开槽的能力，但目前只支持img2img场景，输入、输出及seed 自动开槽，推荐用户手动完成开槽。

开槽流程：

步骤	示意图
在节点上右键选择槽位标记
编辑该节点的槽位信息名称自定义：能明确开槽位置/参数等信息；组建默认即可；
点击左上角「保存」图标，查看全部槽位信息

Tips：对于常见图生图工作流，切记要创建输入图片和输出图片槽位，否则会出现输入图片不生效或服务部署失败/输出为空。文生图同理创建输出图片；

开启自动部署

请务必在工作流跑通后再进行一键部署

点击下方工具图标进入，点击左上一键部署按钮

加载完成后，对「能力名称」进行命名

⚠️该命名也即最终的算法「req_key」，命名需要有明确的业务、场景、名称等信息，后续接入请求和资源、调用量等信息均会绑定该req_key。

只支持字母、数字以及_符号，且不超过 40字符；

不支持以_ 或 _数字结尾；（如i2v_test_ 或 i2v_test_1）

一个部署能力一个 req_key，避免相同能力创建多个 req_key

检查开槽信息

再次确认参数标识(请求 req_json 中的 key )及其对应的工作流节点ID(node_id)、类型(class_type)、属性(input_key)是否符合预期，如果有遗漏参数，需返回房间中重新调整。

部署完成

「一键部署」提交之后，后台会启动自动化测试，可以在服务管理/服务详情了解自动化测试是否完成（大约1-2小时）。如果长时间功能测试未完成，可联系专属的技术支持同学反馈。

测试结果包含2个：

功能测试（0.5-1h）

性能测试（1~2h）

功能测试

功能测试的状态可以在服务详情的部署信息看到。功能测试通过后即可进行接入。

性能测试

性能测试完成的状态可以在服务详情的部署信息看到，性能测试并不会阻塞能力接入。

基准性能数据显示，单实例 GPU 利用率可以达到 45%，单实例 QPS 为 0.106

客户接入

能力与资源接入

已经完成功能测试的能力即可进行接入。

点击接入能力与资源

选择要接入的能力。能力如果包含多个版本可以点击选择。

输入资源名称，后续接入 Openapi 时也需要传递这个参数。

资源日历按照日期申请能力调用的并发/QPS，推荐按照并发申请资源。

如果可申请并发/QPS 不足，请联系技术支持同学开通更多资源。

申请的资源需要一定时间去部署，在服务详情的实例信息可以看到部署状态，达到 healthy 状态的实例即可调用。服务名称的命名为 {能力名称}-dedicated-{资源名称}.

已申请的资源可以进行效果预览

Openapi 能力对接

一键部署的能力支持同步调用(LumiProcess) 和异步调用(LumiSync2AsyncSubmitTask + LumiSync2AsyncBatchGetResults)

LumiProxyApi接入文档

资源修改与释放

已经部署的资源，在到期后会自动释放，可以在到期前修改资源日历，延长资源使用时间。

点击删除资源即可释放资源，不再消耗资源，请务必在线上流量已经结束的情况下再释放资源。

服务升级

服务升级可以通过两种方式来实现：

在现有能力基础上，使用同样的能力名称再次进行一键部署，客户侧无需替换请求 Openapi 的 req_key；

【推荐】使用新的能力名称，重新进行部署、接入，客户侧可以通过替换请求 Openapi 的 req_key 实现升级。

这里主要介绍第一种方式。在完成已有版本的自动部署后，可以在此前 workflow 基础上进行改动，改动完之后可以重新走 2-5 步，选择同样的能力名称。

提交完成一键部署后，会出现新的部署信息。

待自动化测试完成后，可以在实例信息将已申请资源的模板切换成新的模板。

FAQ

申请资源接入时，资源日历可用为 0，该怎么办？

资源日历需要预先申请，消耗算点置换资源日历可用额度。目前只能通过线下联系技术支持同学添加配置

能力接入是否有安全审核

客户可联系技术支持同学，配置默认兜底安全审核，针对输入图/文，输出图配置审核

最近更新时间：2025.07.28 13:37:01

这个页面对您有帮助吗？

有用

无用