> ## Documentation Index
> Fetch the complete documentation index at: https://onehop.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 一个 API Key，轻松接入多款主流 AI 模型
\---感谢用户投稿---
如果你平时经常使用 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](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](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 等公开代码仓库。
可以一键导入你的CCSWITCH，根据你使用的agent选择使用。选择启用，并重启你的agent。
左下角显示onehop就可以成功使用了！
