api.tokios.com 的请求均需携带 Tokios API 密钥作为 Bearer 令牌完成验证。您可在控制台的 Keys 选项卡下创建此类密钥；它们均以 sk-tok- 开头，且可限定为仅用于特定模型。创建密钥完全免费且无需绑定信用卡。
创建密钥
- 打开控制台中的 Keys 选项卡。
- 输入一个 display name（例如
production-app或local-dev）。 - 您还可按需设置 model patterns——即一系列以逗号分隔的 glob 匹配规则，用于限定密钥可访问的模型范围（例如
gemma*、gpt-4*）。若留空*则表示可访问所有模型。 - 点击 Create key，然后 copy the key immediately——密钥仅显示一次。
通过电子邮件分享密钥
若想让团队成员或朋友获得访问权限，又无需亲自处理密钥，可使用 Share Key（位于 Keys 选项卡的 Create key 旁边）。该操作会为对方生成一个全新的专属密钥，并向其发送一封包含一次性查看链接的邮件——密钥本身绝不会出现在邮件中，您也无需查看或复制它。 在 Share a key by email 对话框中：1
Enter the recipient email
指定应接收该密钥的人员。对方只会收到一次性的密钥查看链接，而非密钥内容本身。
2
Set the model scope
选择此共享密钥可调用的模型——其设置规则与普通密钥的模型匹配规则完全一致，因此可将共享密钥的权限限定于恰好一个部署。
3
Optionally add a passphrase and expiry
设置密码（需单独告知收件人）可为查看链接增加第二重验证。Expiry 用于指定密钥失效时间——也可保留为 No expiry。
4
Choose usage visibility, then send
保持 Let them check this key’s usage 处于启用状态，这样接收方就能查看该共享密钥的使用情况（后续您也可针对单个密钥关闭此功能）。若您的工作空间启用了请求日志记录，且希望接收方能够查阅通过该密钥发送的提示内容，还需勾选 Let them read their stored prompts there too——该选项默认关闭，因为任何持有该密钥的人均可读取这些提示内容。然后点击 Send invite。
若您的工作空间开启了请求日志记录，通过共享密钥发送的提示内容也会被保存，收件人在其使用记录页面会看到相应提示。只有在您提前勾选上述提示选项或后续在密钥设置中开启权限后，对方方可查阅这些提示内容。分享密钥前请务必提前告知对方。
使用您的密钥
将该密钥作为 Bearer 令牌发送，并设置与客户端匹配的基础 URL：- OpenAI 风格（Codex、OpenAI SDK）：
https://api.tokios.com/v1 - Anthropic 风格（Claude Code）：
https://api.tokios.com
/v1：
密钥安全
- 切勿将密钥提交至源代码管理系统。 务必避免将其写入已签入的
.env文件或硬编码字符串中。 - 使用环境变量并在运行时读取。
- 定期轮换——创建替换密钥，更新您的服务，然后移除旧密钥。
- 针对不同环境使用独立密钥，这样撤销某个密钥不会影响其他环境。
- 使用模型匹配规则限定作用域，确保密钥仅能访问其所需的模型。
- 了解存储内容。 默认情况下 Tokios 不保存任何请求或响应内容。开启请求日志记录后，工作区管理员可在 7 天内查看工作区中任何密钥发送的提示内容。
- 对管理密钥的脚本使用自动化令牌。 密钥用于调用您的模型，不能创建、轮换或撤销其他密钥。需要执行此类操作的程序应使用有作用域且会过期的自动化令牌。