基础知识
第一次用 API?先弄清地址、密钥、模型名和分组这四样东西。
OpenToken 是 AI 模型的 API 中转站。你在这里充值、创建密钥,客户端把请求发给 OpenToken,OpenToken 校验密钥后转给对应的模型,再把结果返回给你,并按实际用量从余额里扣费。
配置任何客户端,都只需要填下面三项:
| 要填的内容 | 是什么 | 填什么 |
|---|---|---|
| API 地址 | 客户端把请求发到哪里 | https://otokapi.com,是否带 /v1 见下文 |
| API 密钥 | 证明请求是你发的,也决定从谁的余额扣费 | 控制台生成的 sk- 开头的字符串 |
| 模型名 | 要调用哪个模型 | 密钥所属分组里有的模型,怎么查 |
地址要不要带 /v1
这是最常见的填错原因。客户端会在你填的地址后面拼接口路径,而且各家拼法不一样,所以写法也不同:
| 客户端 | 填写的地址 | 客户端实际请求 |
|---|---|---|
| Claude Code | https://otokapi.com | /v1/messages |
| Codex | https://otokapi.com/v1 | /v1/responses |
| Gemini CLI | https://otokapi.com | /v1beta/models/… |
| OpenAI SDK、多数第三方客户端 | https://otokapi.com/v1 | /v1/chat/completions |
| Anthropic SDK | https://otokapi.com | /v1/messages |
报 404 时,先检查这一项。地址填成 https://otokapi.com/v1 再配 Claude Code,实际请求会变成 /v1/v1/messages。
分组是什么
每把密钥都绑定一个分组,分组决定了三件事:
- 能用哪些模型:一个分组通常只提供一个系列的模型,比如 Claude 的分组不能调 GPT。
- 价格:分组有倍率,按模型标准价乘以倍率扣费,倍率越低越便宜。
- 请求走哪些上游渠道:不同分组的速度和稳定性不同。
想同时用 Claude 和 GPT,就分别创建两把绑定不同分组的密钥。
怎么选分组、查模型
分组和模型会随时调整,文档里不列具体名单,以控制台和接口返回的为准:
curl https://otokapi.com/v1/models \
-H "Authorization: Bearer sk-你的密钥"配置客户端、写代码时用的模型名,都从这个列表里选。
请求带密钥的方式
三种请求头都可以,各家 SDK 和客户端会自动选择,自己写代码时任选一种:
Authorization: Bearer sk-你的密钥
x-api-key: sk-你的密钥
x-goog-api-key: sk-你的密钥