创建并管理 Tokios API 密钥

所有发往 api.tokios.com 的请求均需携带 Tokios API 密钥作为 Bearer 令牌完成验证。您可在控制台中的 Keys 选项卡下创建此类密钥；它们均以 sk-tok- 开头，且可限定为仅用于特定模型。创建密钥完全免费且无需绑定信用卡。

创建密钥

打开控制台中的 Keys 选项卡。
输入一个 display name（例如 production-app 或 local-dev）。
您还可按需设置 model patterns——即一系列以逗号分隔的匹配规则，用于限定密钥可访问的模型范围（例如 gemma*、gpt-4*）。若留空 * 则表示可访问所有模型。
点击 Create key 按钮，随后点击 copy the key immediately 按钮——该提示仅会出现一次。

密钥信息仅在创建时显示一次。请立即将其保存至密码管理器或机密信息存储库。若不慎遗失，则需撤销原密钥并重新创建。

您最多可持有 50 个有效密钥。每条密钥记录旁均设有编辑、轮换、disable 以及 delete 等操作按钮。若想让团队成员或朋友获得访问权限，又无需亲自处理 API 密钥，可使用 Share Key（位于“密钥”标签页的 Create key 旁边）。该操作会为对方生成一个全新的专属密钥，并发送一封邮件给他们，内含可一次性使用的密钥查看链接；密钥本身绝不会出现在邮件中，您也无需查看或复制它。在 通过邮件分享 API 密钥 对话框中：

输入收件人的电子邮箱地址。

指定应接收该密钥的人员。对方只会收到一次性的密钥查看链接，而非密钥内容本身。

设定模型使用范围。

选择此共享密钥可调用的模型——其设置规则与普通密钥完全一致，因此也能将权限限定于某个特定的部署环境。

可选：添加密码与有效期设置。

设置密码（需单独告知收件人）可为查看链接增加第二重验证机制。Expiry 用于指定密钥失效时间，也可保留为 No expiry 状态。

确定使用记录可见性后点击发送即可。

请保持 Let them check this key’s usage 处于启用状态，这样接收方就能查看该共享令牌的使用情况（后续您也可针对单个令牌关闭此功能）。若您的工作空间启用了请求日志记录，且希望接收方能够查阅通过该令牌发送的提示内容，请勾选 允许他们查看自己存储的提示信息 选项；该选项默认处于关闭状态，因为一旦开启，任何持有该令牌的用户均可读取这些提示内容。完成设置后，点击 Send invite 即可。

由于共享密钥属于独立生成的专属密钥，您可随时将其撤销，从而立即终止对方的访问权限，且不会影响其他用户的正常使用。这正是本地模型 API 密钥管理中所述针对单人权限管控的最快捷方式。

若您的工作空间开启了请求日志记录，由共享密钥触发的所有提示信息均会被保存，收件人在其使用记录页面也会看到相应提示。只有在您提前勾选上述提示选项或后续在密钥设置中开启权限后，对方方可查阅这些记录。分享密钥前务必提前告知对方此情况。

使用您的 API 密钥

将该密钥作为 Bearer 令牌发送，同时设置对应的基础 URL：

OpenAI 风格（Codex、OpenAI SDK）：https://api.tokios.com/v1
Anthropic 风格（Claude Code）：https://api.tokios.com

curl https://api.tokios.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemma-tunnel", "messages": [{"role": "user", "content": "Hello"}]}'

OpenAI SDK（Python）：

from openai import OpenAI

client = OpenAI(
    api_key="sk-tok-YOUR_KEY",
    base_url="https://api.tokios.com/v1",
)
response = client.chat.completions.create(
    model="gemma-tunnel",
    messages=[{"role": "user", "content": "Hello"}],
)

Anthropic SDK（Python）——在 Anthropic 的接口中基础 URL 内无需包含 /v1：

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-tok-YOUR_KEY",
    base_url="https://api.tokios.com",
)
message = client.messages.create(
    model="gemma-tunnel",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello"}],
)

密钥安全注意事项

切勿将密钥提交至源代码管理系统。务必避免将其写入 .env 文件或硬编码进程序代码中。
建议利用环境变量并在运行时读取这些变量值。
定期更换密钥——先生成新密钥并更新相关服务配置，随后再废弃旧密钥。
针对不同环境使用独立密钥，这样即便撤销某个环境的密钥也不会影响其他环境。
通过模型匹配规则限定密钥权限，确保每个密钥仅能访问其所需的上游模型 ID。
了解存储内容。 默认情况下 Tokios 不会保存任何请求或响应的内容。开启请求日志记录后，工作区管理员即可查看 7 天内所有使用该密钥发出的提示信息。

撤销密钥

在 Keys 标签页中定位到目标密钥，随后执行 disable 或 delete 操作。一旦密钥被撤销，它将即刻失去验证效力，任何携带该密钥的请求均会被拒绝。

入门

模型

概念

参考

创建并管理 Tokios API 密钥

创建密钥

使用您的 API 密钥

密钥安全注意事项

撤销密钥

​创建密钥

​通过电子邮件分享密钥

​使用您的 API 密钥

​密钥安全注意事项

​撤销密钥

创建密钥

通过电子邮件分享密钥

使用您的 API 密钥

密钥安全注意事项

撤销密钥