关于 runway-dev-model-routers
此技能指导开发者在应用中集成和管理 Runway Model Routers,涵盖配置检查、按模态调用 SDK,以及安全处理路由变更和计费测试。
主要功能
- 01按 configId 检查路由器
- 02调用视频、图像和音频 SDK 方法
- 03创建及更新路由器设置
- 04检查可用模型和任务路由
- 05安全处理计费测试
适用场景
- 01核实应用配置的路由器
- 02在服务端应用中接入路由生成
- 03修改设置并保留未变更项
- 04调查任务的路由结果
MCP 相关
此技能使用 Dev MCP 检查和管理路由器、查询可用模型与余额,并查看任务路由情况。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ runwayml/ skills --skill runway-dev-model-routers安装后在 Claude Code 中输入/runway-dev-model-routers确认已加载。
详细介绍
Runway Dev 模型路由器
模型路由器让应用程序可以引用已保存的路由偏好,而不必内嵌特定的模型选择。如果已安装 runway-dev 技能,请参阅其中有关账户设置、凭据处理和 SDK 任务的指南。
现有集成
- 检查应用程序现有的
configId及其服务端请求路径。 - 如果需要验证实时配置或访问权限,请使用 Dev MCP 通过
configId查找路由器,然后使用工具返回的标识符获取详细信息。路由器记录 UUID 与其configId是不同的值;在 SDK 请求中传入已配置的configId。 - 阅读当前概览和生成指南:
https://docs.dev.runwayml.com/model-routers/和https://docs.dev.runwayml.com/model-routers/generating/。路由器请求字段和类型与直接模型端点不同;请使用所调用模态对应的架构。 - 在应用程序的服务端边界后,集成文档中说明的 SDK 方法(
generate.video、generate.image或generate.audio)。从create()直接链式调用 SDK 任务等待助手。 - 对于非计费的路由检查,当前 API 支持 HTTP
dryRun: true;SDK 未记录 dry-run 支持。请确保 dry-run 输入与之后的实际调用等效,并根据当前文档处理响应字段。除非用户要求或批准计费验证,否则不要发起实际调用。
创建或更改路由器
使用实时 MCP 工具检查或管理路由器状态。对于缺失的目标或路由偏好,请先澄清;如果用户已明确指定,则直接执行所请求的创建或更新,无需再次确认,也无需提供 JSON 预览。除非用户要求原始配置,否则请用通俗易懂的英文总结结果。
更新 settings 会替换整个设置对象,并清除未提供的可选字段。更新前请读取当前配置,并保留用户未要求更改的设置。仅更新 name 或 description 不会更改设置。除非用户已经明确要求删除该特定路由器,否则删除前请先确认。
如果当前符合条件的模型和限制会影响配置,请通过 Dev MCP 检查。不要在此技能中硬编码模型目录、定价或模型资格。在执行获批的计费测试前,立即检查项目的额度余额。
根据所请求的操作使用可用的 MCP 工具:使用 list_model_routers 和 get_model_router 进行检查;使用 create_model_router、update_model_router 或 delete_model_router 进行更改;使用 list_models 获取当前符合条件的模型;在执行获批的计费测试前使用 get_credit_balance;使用 get_task_routing 检查现有任务的路由情况。
说明路由结果
响应和任务详情可能会显示路由信息,例如选定的模型以及预估或实际成本。请使用实时响应或文档中说明的任务检查工具描述实际情况;不要仅凭路由器的偏好设置推断其选择了哪个模型。如果用户询问现有任务为何以特定方式进行路由,请通过可用的 MCP 工具检查其路由详情。