> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokios.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Tokios exposes private local models through https://api.tokios.com using an outbound-only connector tunnel.
> Use 'connector' for the local tokios-connector process.
> Use 'deployment' for the public model name in the API model field.
> Use 'upstream model id' for the model served by Ollama, llama.cpp, vLLM, LM Studio, or another local backend.
> API keys use the prefix sk-tok-. Connector tokens use the prefix ct-tok-.

# 为代理和脚本创建自动化令牌

> 铸造一个作用域受限、自动过期的自动化令牌（at-tok-…），让编程代理或脚本无需您的密码即可通过 API 设置和管理 Tokios 工作区。

所谓**自动化令牌**可让程序像您在控制台中一样操作工作区：配对连接器、发布模型、创建 API 密钥、查看用量。您在 **Settings** 中铸造它，精确选择它可执行的操作，并在您指定的日期过期。将它交给 Claude Code 或 Codex 等编程代理、CI 作业或脚本，该程序即可无人值守地完成全部设置。

它不是 API 密钥。API 密钥（`sk-tok-…`）让客户端调用您的模型。自动化令牌（`at-tok-…`）让程序管理工作区，且绝不能通过它调用模型。两者互不交叉。

> [!NOTE]
>
> 自动化令牌仅作用于您自己的工作区。它们绝不能更改您的密码或邮箱、显示或分享 API 密钥、轮换连接器令牌、读取已存储的提示词、更改请求日志记录，或创建其他自动化令牌。这些操作仍需通过已登录的控制台会话完成。

## 创建令牌

仅工作区管理员可以创建、列出或撤销自动化令牌。

**1. 打开 Settings**

在控制台中，打开 **[Settings](https://tokios.com/console/settings)** 并滚动到 **Automation tokens**。点击 **Create token**。

**2. 以持有者命名**

使用您在令牌列表及其创建的行中能识别的名称，例如 `claude-code on my laptop` 或 `ci-deploy`。

**3. 选择预设或自定义作用域**

**Setup** 是安装连接器并使模型可被调用的代理的正确预设。**Read-only** 适用于监控。**Full** 授予所有作用域。其他情况可勾选单独的作用域。参见下方[作用域](#scopes)。

**4. 选择过期时间**

每个令牌都会过期。一次性设置运行选择 1 hour，长期任务选择更长时间。最长为 1 year。

**5. 一次性复制令牌**

令牌仅显示一次。将其复制到程序的机密存储或 shell 变量中。如果丢失，从列表中点击 **Regenerate**；旧值立即失效。

## 作用域

作用域格式为 `resource:verb`。`write` 作用域包含对应的 `read`。没有任何作用域包含 `keys:rotate` 或 `models:reroute`。

| 作用域 | 允许的操作 |
| - | - |
| `connectors:read` | 列出连接器并读取其实时状态和主机统计信息 |
| `connectors:write` | 发起配对、批准、重命名、撤销和删除连接器。删除仍在为模型提供服务的连接器还需要 `models:reroute` |
| `models:read` | 列出模型、部署、模型组、价格、限额和连接信息 |
| `models:write` | 创建、编辑、暂停和恢复模型；创建、编辑和删除模型组；设置价格和自动发布 |
| `models:reroute` | 将现有模型移到另一个连接器、重命名或删除它。每项操作都会改变接收该模型流量的机器，因此还需要 `models:write`，并且不包含在任何预设中，除了 **Full** |
| `keys:read` | 列出 API 密钥（指纹和设置，绝不包含密钥本身） |
| `keys:write` | 创建、编辑、撤销和删除 API 密钥（新创建密钥的密钥值仅返回一次） |
| `keys:rotate` | 轮换现有 API 密钥并获取其新密钥值。此操作会接管持有者的密钥，因此不包含在任何预设中，除了 **Full** |
| `usage:read` | 读取用量、花费和请求日志（仅计数和元数据） |
| `playground:run` | 运行 Playground 和模型健康检查（向您的模型发送提示词） |

| 预设 | 作用域 |
| - | - |
| **Setup** | `connectors:read`、`connectors:write`、`models:read`、`models:write`、`keys:read`、`keys:write`、`playground:run` |
| **Read-only** | `connectors:read`、`models:read`、`keys:read`、`usage:read` |
| **Full** | 上述所有作用域 |

超出令牌作用域的调用会返回 `403`，并在错误中指明缺少的作用域，因此程序可以准确告知您它缺少哪项授权。

## 使用令牌

将其作为 Bearer 令牌发送至控制台主机，而非 API 主机。所有管理调用均位于 `https://tokios.com/account/` 下。

**macOS & Linux**

```bash theme={"theme":{"light":"github-light","dark":"css-variables"}}
curl -s https://tokios.com/account/connectors \
  -H "Authorization: Bearer at-tok-YOUR_TOKEN"
```

**Windows CMD**

```cmd theme={"theme":{"light":"github-light","dark":"css-variables"}}
curl -s "https://tokios.com/account/connectors" -H "Authorization: Bearer at-tok-YOUR_TOKEN"
```

| 响应 | 含义 |
| - | - |
| `401` | 令牌无效、已过期或已撤销，创建它的管理员更改或重置了密码，或工作区或该管理员已被暂停。 |
| `403` 带 `"scope"` | 令牌缺少该作用域。 |
| `403` "only available from the console" | 该操作仅限已登录的控制台会话。没有任何作用域可授权。 |
| `429` | 此令牌在一分钟内超过 240 次调用，或此地址的令牌失败尝试过多。锁定会覆盖该地址的所有令牌，包括有效令牌。请稍后重试。 |

有关完整调用列表及无人值守设置的调用顺序，请参阅[让编程代理为您设置 Tokios](/zh/guides/agent-setup.md)。

## 交给代理

使用 **Setup** 预设和 1 hour 过期时间创建令牌，然后在运行模型的机器上启动代理，并发送以下提示词：

```text theme={"theme":{"light":"github-light","dark":"css-variables"}}
Read https://docs.tokios.com/guides/agent-setup and follow it. The console base URL is https://tokios.com and the automation token is in the TOKIOS_TOKEN environment variable. Never print the token. My model server is Ollama on this machine. When you are done, give me the final report described on that page.
```

在启动代理之前，先在 shell 中设置 `TOKIOS_TOKEN`，这样密钥就不会出现在对话中。指南页面会告知代理其他所有信息。

## 管理令牌

在 **Settings** 中，每一行显示令牌的作用域、指纹、过期时间以及最后一次使用的时间和 IP 地址。

* **Regenerate** 替换密钥值。旧值立即失效，新值仅显示一次。
* **Revoke** 永久停用令牌。需创建新令牌替代。
* **Delete** 从列表中移除已撤销或已过期的令牌。

更改或重置密码会撤销您创建的所有令牌。从被盗会话中铸造的令牌会在您恢复账户后立即失效，任何常驻作业之后都需要新的令牌。

自动化令牌创建的行在 **Connectors**、**Models** 和 **Keys** 选项卡上带有 **via token** 标记，因此您始终可以分辨程序执行了哪些操作。即使令牌被删除，该标记仍会保留。

## 保障令牌安全

* **缩小作用域。** 已完成任务的 Setup 令牌应被撤销，而非保留。
* **尽快过期。** 交互式代理会话使用 1 hour。长期过期仅适用于机密存储中的常驻任务。
* **不要出现在对话记录中。** 从 shell 变量读取；切勿将其粘贴到与代理的聊天中。
* **关注标记和最后使用时间列。** 如果令牌从您不认识的地址被使用，请撤销它。
* **了解铸造密钥的含义。** 具有 `keys:write` 的令牌可以创建 API 密钥，且该密钥在令牌过期后仍然有效。窃取 1 小时 Setup 令牌的人可以铸造一个永不过期的密钥并持续调用您的模型，直到您发现。在任何代理运行后，打开 **Keys** 选项卡，查找标记为 **via token** 的行，并撤销任何您未预期的行。
* **仅在需要时授予 `models:reroute`。** 移动、重命名或删除现有模型会改变接收其流量的机器。同时能够配对连接器的令牌可以配对其持有者控制的机器，并把您的模型移到那里。Setup 永远不需要它：它会创建模型，但从不移动模型。
* **共享地址会共享锁定。** 来自同一 IP 地址的令牌失败尝试达到 8 次后，该地址的所有令牌都会被以 `429` 拒绝，持续 6 分钟，包括有效令牌。位于同一办公网络、NAT 网关或 CI 运行器池后面的代理会共享该锁定。如果某个客户端一直发送错误的令牌，请停止或修复它，而不是让它循环重试。

> **[代理驱动的设置](/zh/guides/agent-setup.md)**
>
> 代理使用 Setup 令牌执行的逐步操作流程。

> **[API 密钥](/zh/setup/api-keys.md)**
>
> 您的客户端用于调用模型的密钥。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.