mcpField
R
runway-dev-models

runway-dev-models

github.com/runwayml开发74732 次安装2 天前更新
代码仓库

关于 runway-dev-models

面向在应用中集成 Runway Dev 模型的开发者，指导将模型请求置于应用服务器端，并按具体端点文档处理输入、任务和输出。

主要功能

  1. 01检查应用现有输入与输出流程
  2. 02通过 Dev MCP 查询模型
  3. 03查阅当前端点文档
  4. 04使用官方 SDK 创建并等待任务
  5. 05处理错误并验证输入与密钥

适用场景

  1. 01在应用现有流程中接入 Runway 模型
  2. 02依据项目权限和约束选择端点
  3. 03安全处理上传、临时输出链接及 API 密钥

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/runwayml/skills --skill runway-dev-models

安装后在 Claude Code 中输入/runway-dev-models确认已加载。

详细介绍

Runway Dev 模型

将直接模型端点集成到应用现有的服务器和用户流程中。如果已安装 runway-dev 技能，请参阅其中的账户设置、凭据边界和共享 SDK 指南。

工作流

  1. 检查应用，确定用户在哪里提供输入并获取输出。将 Runway 请求限制在应用的服务器边界内。
  2. 遵循用户或现有应用明确选择的模型。如果必须选择模型，或当前项目的访问权限和限制很重要，请使用 Dev MCP 的 list_models 查询相关项目和端点。切勿猜测项目 ID，也不要根据模型名称推断访问权限。 对于目录摘要，保留每个端点返回的价格单位和限制，并根据完整响应核对模型数量。
  3. 从 https://docs.dev.runwayml.com/llms.txt 和 https://docs.dev.runwayml.com/api.md 阅读当前端点的准确参考文档。不同模型的字段、允许值、输入和输出可能不同；切勿照搬相邻端点的架构。
  4. 使用适用于应用所用语言的官方 SDK。对于创建任务的调用，应从未等待的 create() 响应继续调用 waitForTaskOutput() 或 wait_for_task_output()。处理文档中说明的任务错误，并让用户检查或恢复任务，而不是悄悄重新提交。
  5. 将成功、加载和错误状态接入现有界面。签名输出 URL 是临时的；如果应用之后还需要媒体，请将其持久化。
  6. 运行适当的本地验证。实时生成会产生费用：仅在用户要求或批准时执行，并在执行前立即检查所选项目的余额。

输入和凭据

遵循当前输入文档中关于 HTTPS URL、数据 URI 和上传 URI 的说明。对于在浏览器中选择的文件，将文件发送到应用服务器，并使用 SDK 文档说明的上传流程。不要向 API 传递本地文件系统路径，也不要未经验证就接受客户端提供的任意远程 URL。

将 RUNWAYML_API_SECRET 保存在服务器上，使用项目现有的密钥管理机制。切勿将其暴露给浏览器代码或放入 MCP 配置中；Dev MCP 使用独立的 OAuth。

当前文档

评论

支持 Markdown