Skip to main content
---感谢用户投稿--- 如果你平时经常使用 AI 编程工具、AI Agent 或各种支持 API 的开发工具,相信一定遇到过一个比较麻烦的问题: 不同模型需要不同的 API,切换模型还要重新配置。 今天给大家介绍一个比较方便的解决方案——OneHop。 OneHop 是一个面向开发者的 AI Gateway,可以通过一个统一的 API 接口接入多家主流 AI 模型。包括 OpenAI、Anthropic、Google、DeepSeek、Qwen、Mistral、xAI、MiniMax 等多个模型生态。相比一个个申请、配置不同平台的 API,OneHop 的思路就是把这些模型统一到一个入口里。

一、OneHop 有什么优势?

1、一个 API Key 管理多个模型
使用 OneHop 后,不需要针对每一家模型单独配置一套接口。
官方目前支持 OpenAI-compatible、Anthropic-compatible 以及 Google Vertex 等协议。对于已经在使用 OpenAI SDK 的开发者来说,很多情况下只需要修改 base_url,原来的调用方式就可以继续使用。
例如原本使用 OpenAI SDK:
from openai import OpenAI
client = OpenAI( api_key=“你的API_KEY” ) 使用 OneHop 后,只需要将地址改成: from openai import OpenAI client = OpenAI( api_key=“你的ONEHOP_API_KEY”, base_url=“https://api.onehop.ai/v1
也就是说,很多情况下不用重新改整个项目,只需要调整 API 地址和模型名称。
2、模型切换更加方便
如果你的项目需要同时测试多个模型,频繁更换 API 会比较麻烦。OneHop 将不同供应商的模型统一在一个模型目录中,可以通过 /v1/models 查询当前可用模型,并根据供应商、协议、能力等条件进行筛选。
例如:
openai/gpt-5.5
anthropic/claude-opus-4.8
实际使用时,建议直接以 OneHop 当前模型列表返回的模型 ID 为准,而不要把某个模型名称永久写死在程序里。 3、支持流式输出
如果你在使用 AI 编程工具或者聊天应用,通常都会比较在意响应速度和实时输出体验。
OneHop 支持 stream: true 的流式请求,可以按照常见的 Server-Sent Events(SSE)方式返回内容,而不是等模型完整生成后再一次性返回。
对于 AI Agent、代码生成以及长文本输出等场景,这一点还是比较实用的。
4、按实际使用量计费
OneHop 采用预付费 Credit 的方式进行使用,官方介绍为按实际使用量计费,并提供统一的账单和用量查看功能。官方还表示,未使用的账户余额可以申请退款。
对于只是想测试模型、开发个人项目的人来说,这种模式会比较灵活,不需要为了一个 API 长期订阅套餐。
https://youtu.be/inZ6fzyCbnQ?si=vwW_zsyJmTDachXn

二、OneHop 怎么使用?

整个过程其实非常简单,大致可以分成四步。 第一步:注册 OneHop 首先进入 OneHop 官方网站并注册账号一个 OneHop API,调用所有 AI 模型,可以分享自己的邀请链接注册 —— 7 天内首充,双方各得 10% 返利。 注册完成后进入平台控制台。官方目前会提供试用额度,具体额度和活动规则以平台当前页面显示为准。 第二步:充值 如果试用额度不足,可以在账户中充值 Credit。 OneHop 采用预付费模式,使用多少扣多少,具体模型的价格可以在模型目录和控制台中查看。 建议第一次使用时先少量充值,确认模型、接口以及自己的开发工具都能够正常使用之后,再根据实际需求增加额度。 第三步:创建 API Key 进入 OneHop 的控制台,创建自己的 API Key。 创建之后,你会得到类似: oh_xxxxxxxxxxxxx 这样的密钥。 API Key 一定不要公开。 不要把它直接发到群聊、论坛,也不要上传到 GitHub 等公开代码仓库。
Image
Image
可以一键导入你的CCSWITCH,根据你使用的agent选择使用。选择启用,并重启你的agent。
Image
Image
左下角显示onehop就可以成功使用了!
Image