跳到正文
OpenToken 文档

基础知识

第一次用 API?先弄清地址、密钥、模型名和分组这四样东西。

OpenToken 是 AI 模型的 API 中转站。你在这里充值、创建密钥,客户端把请求发给 OpenToken,OpenToken 校验密钥后转给对应的模型,再把结果返回给你,并按实际用量从余额里扣费。

配置任何客户端,都只需要填下面三项:

要填的内容是什么填什么
API 地址客户端把请求发到哪里https://otokapi.com,是否带 /v1 见下文
API 密钥证明请求是你发的,也决定从谁的余额扣费控制台生成的 sk- 开头的字符串
模型名要调用哪个模型密钥所属分组里有的模型,怎么查

地址要不要带 /v1

这是最常见的填错原因。客户端会在你填的地址后面拼接口路径,而且各家拼法不一样,所以写法也不同:

客户端填写的地址客户端实际请求
Claude Codehttps://otokapi.com/v1/messages
Codexhttps://otokapi.com/v1/v1/responses
Gemini CLIhttps://otokapi.com/v1beta/models/…
OpenAI SDK、多数第三方客户端https://otokapi.com/v1/v1/chat/completions
Anthropic SDKhttps://otokapi.com/v1/messages

报 404 时,先检查这一项。地址填成 https://otokapi.com/v1 再配 Claude Code,实际请求会变成 /v1/v1/messages。

分组是什么

每把密钥都绑定一个分组,分组决定了三件事:

  • 能用哪些模型:一个分组通常只提供一个系列的模型,比如 Claude 的分组不能调 GPT。
  • 价格:分组有倍率,按模型标准价乘以倍率扣费,倍率越低越便宜。
  • 请求走哪些上游渠道:不同分组的速度和稳定性不同。

想同时用 Claude 和 GPT,就分别创建两把绑定不同分组的密钥。

怎么选分组、查模型

分组和模型会随时调整,文档里不列具体名单,以控制台和接口返回的为准:

想知道去哪里看
有哪些分组,各自的倍率和适合做什么控制台创建密钥时的分组下拉框,每个分组下面都有说明
一把密钥能用哪些模型调用下面的 GET /v1/models
各分组现在稳不稳定渠道状态
curl https://otokapi.com/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

配置客户端、写代码时用的模型名,都从这个列表里选。

请求带密钥的方式

三种请求头都可以,各家 SDK 和客户端会自动选择,自己写代码时任选一种:

Authorization: Bearer sk-你的密钥
x-api-key: sk-你的密钥
x-goog-api-key: sk-你的密钥

接下来

本页内容