API Key 管理

API Key 用于客户端、脚本或第三方应用调用 TFlow API。每个 Key 可以独立设置名称、状态、额度、有效期、模型范围、来源 IP 和 Trace 可见性。

调用地址与查找

页面顶部展示当前平台的 OpenAI 兼容和 Anthropic 兼容 Base URL，可点击复制按钮写入 SDK 或客户端配置。发布环境请使用页面实际展示的 https://tflow.ai-links.com 域名，不要照搬测试环境地址。

列表支持按名称模糊搜索（可使用 % 通配）和按完整 API Key 精确搜索。还可以刷新列表、勾选多条记录后批量删除；批量删除前请确认这些 Key 没有被线上客户端使用。

创建 API Key

进入“API Keys”页面，点击“新建 API Key”。

常用配置包括：

• API Key 名称：用于在列表和日志中快速识别用途，例如“个人使用”“OpenCode”“ChatBox”。
• 启用状态：新建 Key 创建后立即生效；编辑时可以切换启用或禁用。
• 无限额度 / 剩余额度：关闭“无限额度”后填写可用余额；余额耗尽后请求会被拒绝。
• 永不过期 / 过期时间：关闭“永不过期”后必须选择日期；到期后 Key 自动失效。
• 令牌分组：请求会使用所选分组进行渠道路由和计费，创建时必须从当前账号可用分组中选择。

访问边界

建议根据使用场景设置访问边界：

• 启用模型限制：只允许调用指定模型。
• 允许模型：多个模型使用英文逗号分隔，例如 gpt-4o,qwen-max。
• IP 白名单：支持 IPv4、IPv6、CIDR，可用逗号或换行粘贴。留空表示不限制来源 IP。
• Trace 可见性：开启后，该 Key 产生的后续请求可在使用日志中查看 Trace 入口。

查看和复制 Key

列表默认展示脱敏 Key，只有按需读取时才显示完整值。需要配置客户端时，点击显示或复制图标；点击“使用 API Key”还可以按 macOS/Linux 或 Windows 复制 Codex CLI、OpenCode、OpenClaw、Hermes Agent 和 Claude Code 配置模板。

完整 Key 属于敏感凭据。只应保存到密码管理器、环境变量或受控配置文件中，不要贴到公开文档、工单、聊天窗口或截图中。

编辑和删除

列表可直接切换启用状态和 Trace 可见性，也可以点击编辑图标进入编辑窗口，修改名称、状态、额度、有效期和访问边界。

点击删除图标后，系统会再次要求确认。删除后该 API Key 会立即无法调用 API，已部署到客户端的配置也会失效；建议先停用并观察，再执行删除。