登录
全部指南

GetRun 桌面 App 和 API Key，应该从哪个开始？

按任务、权限和结果检查方式，选择 GetRun Harness、已有 AI 客户端或直接 API 集成，并完成最小可用验证。

GetRun 编辑团队

先看你要完成的工作。GetRun Harness 提供用于 Agent 任务的桌面工作区；API Key 用来连接已有客户端或你自己的程序。两种方式可以配合使用，但配置位置、权限范围和检查结果的方式不同。

需要围绕本地项目交互时，先试桌面 App

如果你想选择项目目录，在会话里描述任务，并查看 Agent 使用了哪些文件和工具，可以先试 GetRun Harness。整理本地笔记、围绕项目逐步完成任务，都便于直接检查最终文件。

安装适合操作系统的版本，通过账号登录或手动填写 Key 连接，再选择工作区与当前 Key 可用的模型。开始前确认运行模式与文件权限。Browser Use 和 Computer Use 是单独的设置，任务确实需要时再启用。

  • 需要工作区和对话界面。
  • 有人能够检查操作，并验收生成的文件。
  • 任务依赖本地上下文，而不仅是一段独立问题。

已经习惯某个客户端时，先配置 API Key

如果工作已经在某个编程工具或受支持的客户端里进行，优先阅读这个客户端对应的接入文档。通常要配置 Key、接口地址和准确的公开模型标识。不同客户端对协议和地址的要求不同，照搬另一个工具的配置，可能在第一次请求时才发现不兼容。

在现有 GetRun 账户控制台创建 Key，按对应指南保存配置，再发送“只回复 OK”这样的小请求。确认响应后查看用量，再开始较大的任务。官网域名不是模型 API 地址，应使用客户端文档中给出的接口地址。

  • 使用目标客户端对应的配置指南。
  • 从当前模型目录复制模型标识，不凭展示名称猜测。
  • 截图、仓库和共享日志中不要包含完整 Key。

由自己的程序控制流程时，再做直接 API 集成

当业务程序需要构造请求、处理响应并决定调用时机时，直接 API 集成更合适。同时，错误处理、面向用户的状态以及凭据存放也由你的程序负责。Key 应保存在可信服务端，不要写入公开浏览器代码。

按具体操作阅读 API 参考；如果使用流式响应或工具相关字段，也要检查对应契约。兼容性需要针对接口与模型组合验证，不能据此假定所有客户端选项都可用。先验证一条完整成功请求和一个错误分支，再设计更长的自动化流程。

用一个最小实验作决定

需要人工验收本地文件，就做一个桌面任务；已有成熟客户端，就验证一次配置；要做产品功能，就实现一次服务端调用并清楚显示成功或失败。先证明它能帮助完成当前工作，再决定是否迁移更大范围的流程。

目前 get-run.com 提供产品介绍、下载、指南和文档；登录、Key 管理和充值仍由 get-apikey.com 承接。沿网站中的账户入口访问即可，营销域名变化不会创建另一份余额或另一个模型 API 服务。

  • 最终在哪里验收：文件、客户端，还是自己的应用？
  • 谁控制工具权限与重试？
  • 扩展任务之前，能否查看第一次调用的实际用量？

三个选择示例

整理五份本地项目笔记 → 从 Harness 工作区开始。
继续使用已有编程客户端 → 按对应指南配置 API Key。
为自己的服务增加模型功能 → 实现服务端 API 请求和明确的错误处理。

接着开始使用