# 一键部署详细操作步骤 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_02e7c7eddcda3dad2c2ea84c03a14950.png) 1. ## 炉米房间新建或导入工作流 https://console.volcengine.com/lumi/home/ai_capability ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_0bd1cf1a083bb9e91e621f68b51d3ea6.png =618x) 2. ## workflow 参数定义（开槽）参数定义也就是常说的「开槽」，这里是明确 workflow 中的哪些节点被开放，将 ComfyUI 工作流中的参数暴露为算法服务 API 中的参数信息，未被「开槽」的节点参数将统一封装。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bd0b10eacd1b3880129c84946fd256e1.png =618x) 常见开槽参数： 1. loadimage+saveimage：上传图、输出结果图 2. ksample： 1. denoise 2. seed 3. prompt: 跟设计师确认具体开槽节点这意味着在后续的 API 接入中： **以上参数会显示默认值，并可以被调整** 实际部署中仅需根据业务需求开放对应参数即可，「一键部署」功能提供自动开槽的能力，但目前**只支持img2img场景**，输入、输出及seed 自动开槽，推荐用户手动完成开槽。 **开槽流程：** |

|

|\ |步骤

|示意图

|\ | | | |---|---| |1. 在节点上**右键**|

|\ |2. 选择**槽位标记**|

|\ || |\ | | | |3. 编辑该节点的槽位信息|

|\ | 1. 名称自定义：能明确开槽位置/参数等信息；|

|\ | 2. 组建**默认**即可；| |\ || |\ | | | |4. 点击左上角「保存」图标，查看全部槽位信息 |

|\ | |

|\ | ||\ | |

|\ | |

|\ | | | * Tips：对于常见图生图工作流，切记要创建输入图片和输出图片槽位，否则会出现输入图片不生效或服务部署失败/输出为空。文生图同理创建输出图片； 3. ## 开启自动部署请务必在工作流跑通后再进行一键部署 1. 点击下方工具图标进入，点击左上一键部署按钮 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ba33ac7f3f9020b60593453e349db9f6.png =681x) 2. 加载完成后，对「能力名称」进行命名 1. ⚠️该命名也即最终的算法「req_key」，命名需要有明确的业务、场景、名称等信息，后续接入请求和资源、调用量等信息均会绑定该req_key。 1. 只支持字母、数字以及_符号，且不超过 40字符； 2. 不支持以_ 或 _数字结尾；（如i2v_test_ 或 i2v_test_1） 3. 一个部署能力一个 req_key，避免相同能力创建多个 req_key ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3ef4b557e0d5641be26e71c2ac5c5d97.png =709x) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e62f78bc6ed7bf1cff832e61ce1ede18.png =709x) 3. **检查**开槽信息 1. 再次确认参数标识(请求 req_json 中的 key )及其对应的工作流节点ID(node_id)、类型(class_type)、属性(input_key)是否符合预期，如果有遗漏参数，需返回房间中重新调整。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8a425e48426f6a67f8bdfe8a837348fc.png =711x) 4. ## 部署完成 **「一键部署」提交之后，后台会启动自动化测试，可以在服务管理/服务详情了解自动化测试是否完成（大约1\-2小时）。如果长时间功能测试未完成，可联系专属的技术支持同学反馈。** 测试结果包含2个： * 功能测试（0.5\-1h） * 性能测试（1~2h） 1. ### 功能测试 * ### 功能测试的状态可以在服务详情的部署信息看到。功能测试通过后即可进行接入。 ### ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_41dc777ccf3fc480e6868dae1bc11290.png =713x) 2. ### 性能测试 * 性能测试完成的状态可以在服务详情的部署信息看到，性能测试并不会阻塞能力接入。 * 基准性能数据显示，单实例 GPU 利用率可以达到 45%，单实例 QPS 为 0.106 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c89452e06595f8a51ba2ab441b7b90dd.png =710x) 5. ## 客户接入 1. ### 能力与资源接入已经完成功能测试的能力即可进行接入。 1. 点击接入能力与资源 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_be7b9ccd3929daa45a225a32a5a2e2fa.png =714x) 2. 选择要接入的能力。能力如果包含多个版本可以点击选择。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_4c831ab6ba93a3584bf9a2c5bb5d8e34.png =719x) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8221a0326aa134d7cab81d8d04732a37.png =716x) 3. 输入资源名称，后续接入 Openapi 时也需要传递这个参数。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8047518d7e2b384dfee19bf06e13c2cf.png =720x) 4. 资源日历按照日期申请能力调用的并发/QPS，推荐按照并发申请资源。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_887562b6cd6ab793d3c1a34df5259247.png =719x) 5. 如果可申请并发/QPS 不足，请联系技术支持同学开通更多资源。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2e904108d748001e536d9d389aca06f2.png =722x) 6. 申请的资源需要一定时间去部署，在服务详情的实例信息可以看到部署状态，达到 healthy 状态的实例即可调用。服务名称的命名为 {能力名称}\-dedicated\-{资源名称}. ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_98ab110fd337e17341a01d5a34f8bd49.png =716x) 8. 已申请的资源可以进行效果预览 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_fc18f8c8df8c129fab756265c524d88c.png =721x) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5a0de365f3ddd22d2e464f65867fa457.png =719x) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f86255e4a589917f40e2cb79f973a350.png =720x) 2. ### Openapi 能力对接一键部署的能力支持同步调用(**LumiProcess**) 和异步调用(**LumiSync2AsyncSubmitTask + LumiSync2AsyncBatchGetResults**) [LumiProxyApi接入文档](https://bytedance.larkoffice.com/docx/K71JdyUAAokaqRxzBMncoFCOnSd) 3. ### 资源修改与释放 1. 已经部署的资源，在到期后会自动释放，可以在到期前修改资源日历，延长资源使用时间。 ### ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ac86be1bc7d5270ef1f1e339567e1831.png =698x) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_98954b450a6942387b99e3c1d547ffec.png =695x) 2. 点击删除资源即可释放资源，不再消耗资源，请务必在线上流量已经结束的情况下再释放资源。![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_29acb75e8868dc754724fa9ac0a08a18.png =696x) 6. ## 服务升级服务升级可以通过两种方式来实现： 1. 在现有能力基础上，使用同样的能力名称再次进行一键部署，客户侧无需替换请求 Openapi 的 req_key； 2. 【推荐】使用新的能力名称，重新进行部署、接入，客户侧可以通过替换请求 Openapi 的 req_key 实现升级。这里主要介绍第一种方式。在完成已有版本的自动部署后，可以在此前 workflow 基础上进行改动，改动完之后可以重新走 2\-5 步，选择**同样的能力名称**。 1. 提交完成一键部署后，会出现新的部署信息。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_58e93359a241ae5c466a2ecc6d3fd7a2.png =671x) 2. 待自动化测试完成后，可以在实例信息将已申请资源的模板切换成新的模板。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b5d2de0b6b2c402733a65a3e694234c9.png =678x) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f89dcb31dffabba2a79201ad642177e1.png =682x) # FAQ 1. ## 申请资源接入时，资源日历可用为 0，该怎么办？资源日历需要预先申请，消耗算点置换资源日历可用额度。目前只能通过线下联系技术支持同学添加配置 2. ## 能力接入是否有安全审核客户可联系技术支持同学，配置默认兜底安全审核，针对输入图/文，输出图配置审核

智能视觉服务