跳到主要内容
AI教程

RouterHub API 教程:探索模型、获取 API 密钥并从 OpenRouter 迁移

本教程通过 RouterHub 文档中心介绍该平台,展示如何浏览模型目录、获取 API 密钥、查看定价和模型变体,并按照 API 快速入门或迁移指南了解实施细节。

RouterHub API 教程:探索模型、获取 API 密钥并从 OpenRouter 迁移

RouterHub 提供的内容

RouterHub 被定位为 OpenRouter 的替代方案,提供实时的模型目录和 API 访问流程。该仓库是一个文档中心,涵盖模型发现、API 使用、迁移、定价、变体、使用场景、安全性和故障排除。

文档按一系列主题明确的指南组织。你可以从头到尾阅读,也可以直接跳转到与你的任务匹配的主题。

选择正确的起点

设置访问权限

  1. 打开RouterHub 注册页面,按照引导流程获取 API 密钥。
  2. 查看模型目录文档,确定应用所需的确切模型 ID 和支持的协议。
  3. 如果你要迁移现有的 OpenRouter 集成,请参阅迁移指南,了解文档中记录的基础 URL、密钥处理和模型映射。
  4. 使用API 快速入门构建并发送第一个请求。

请妥善保管 API 密钥。将其存储在环境变量或其他密钥管理系统中,不要直接写入源代码。

查找正确的模型

模型选择是 RouterHub 工作流程的重要组成部分。该仓库专门提供了模型目录指南,介绍模型系列、模型 ID 和协议。请将该指南与实时模型目录结合使用,不要猜测标识符。

实际的选择流程如下:

  1. 明确任务类型,例如编程、代理工作流、研究或写作。
  2. 浏览可用的模型系列和变体信息。
  3. 复制目录中显示的确切模型 ID。
  4. 确认模型协议与计划使用的客户端或集成相匹配。
  5. 发送生产流量前查看定价文档。

发送第一个 API 请求

该仓库引导用户使用 API 快速入门发送第一个请求。由于确切的端点和请求格式会在该指南中维护,请使用其中的当前值,不要从次要示例中硬编码端点。

设置请求通常需要以下文档中记录的值:

API 密钥:<你的 RouterHub API 密钥>
基础 URL:<RouterHub API 快速入门中的值>
模型 ID:<模型目录中的确切 ID>
协议:<所选模型支持的协议>

如需具体实现,请打开API 快速入门,复制其中的请求示例,安全地设置 API 密钥,并将模型值替换为从目录中选定的确切 ID。

迁移现有的 OpenRouter 集成

如果你的应用已经使用 OpenRouter,请按照仓库的迁移指南操作。README 指出了三个迁移重点:更改基础 URL、使用 RouterHub API 密钥,以及映射模型标识符。

测试前请使用以下检查清单:

  • 根据迁移文档更新提供商基础 URL。
  • 将现有凭据替换为 RouterHub API 密钥。
  • 检查每个模型名称,并将其映射到确切的 RouterHub 模型 ID。
  • 确认所选模型所需的协议。
  • 将集成投入生产前,先发送一个小型测试请求。

如需了解切换原因的更多背景,请阅读为什么切换,其中涵盖文档提到的预付费计费、模型 ID 和无审查选项。

查看定价和模型变体

定价

定价指南介绍按令牌计费的示例。使用该指南估算目标工作负载的成本,并在扩大请求规模前比较不同模型。

无审查与消融模型

无审查与消融模型指南用于比较这些变体。请同时阅读仓库的安全性指南,并以合法且负责任的方式使用任何模型。

探索实际使用场景

第一个请求成功后,使用场景指南将介绍编程、代理、研究和写作。利用这些示例,将模型系列和协议与正在构建的应用类型进行匹配。

对于操作问题,请参阅故障排除指南。该指南专门介绍身份验证、模型 ID 和协议。常见问题提供更详细的解答,而术语表解释整个文档中使用的术语。

高级提示

  • 优先使用准确的 ID:从目录中复制模型标识符,避免因名称差异导致失败。
  • 尽早检查协议:在调试应用代码前,先验证协议兼容性。
  • 将配置与代码分离:让 API 密钥、基础 URL 和模型 ID 可配置,以便更轻松地进行迁移和测试。
  • 先估算成本:在运行大型工作负载前,先参考按令牌计价的示例。
  • 使用文档路径:根据需要选择迁移、快速入门、定价或故障排除指南,不要将每个集成问题都视为一般 API 问题。
  • 进行安全审查:评估未审查或已移除安全限制的变体时,请阅读安全指南,并将使用限制在合法用途内。

结论

RouterHub 代码库为评估 OpenRouter 替代方案并集成其 API 提供了结构化起点。首先获取 API 密钥,从目录中选择准确的模型 ID,验证协议,然后按照 API 快速入门操作。如果要迁移现有应用,请使用专门的迁移指南,然后在部署前验证定价、变体、安全性和故障排除等注意事项。