快速开始

本指南帮助你接入 TokenFactory 词元工厂。先判断一件事：你准备在自己的程序中调用 API，还是配置已有工具。两条路径共用账号体系和公开模型查询；建议为每个应用或工具分别创建 API Key，便于单独停用和排查。

先选择你的场景

场景一在自己的程序中调用 API适合网站、服务、脚本和自动化，准备 Key 和模型后前往接口页在线测试。完成标志 接口测试返回成功状态与完整响应 场景二配置到已有工具适合桌面客户端、IDE 和编码代理，按协议与权益复制对应 Base URL。完成标志 选中 Token Factory 配置和预期模型，并得到非空回复

需要自己编写请求和处理响应时选第一条；工具已经提供 Base URL、API Key 和模型字段时选第二条。点击场景卡后，会从该路径所需的准备步骤开始，不会跳过 Key 或模型配置。

在自己的程序中调用 API

适用于网站、服务、脚本、自动化和 AI 编程。当前使用通用余额按量计费，充值后按实际用量扣费。

1. 创建 API Key

进入控制台的 API Keys 页，为当前应用创建并复制 API Key。

2. 选择模型并复制 ID

在模型文档中选择已开放 OpenAI Chat Completions 的模型，复制模型 ID。

3. 在线测试对话补全

在测试弹窗中粘贴 Key，修改请求体中的 model，点击发送查看完整响应。

在线测试对话补全 →

其他 API 也可在API 文档中进入对应接口页在线测试，无需安装工具或设置终端变量。正式接入时，请在服务端保管 API Key。

配置到已有工具

工具同样使用通用余额按量计费。这里填写的是 Base URL，工具会在它后面追加具体请求路径；先选工具和协议，再复制教程中唯一匹配的 Base URL。

1. 选择工具并打开教程

你的接入目标	教程
终端编码工具	Claude Code、Codex、OpenCode、Pi
智能体与个人助手	OpenClaw、Hermes
统一管理工具配置与查询余额	CC Switch
其他 OpenAI / Anthropic 兼容客户端	兼容客户端配置

每篇教程都会说明适用协议和权益，并提供可一键复制的 Base URL。通用客户端无法确定协议时，使用兼容客户端配置逐项判断。

2. 准备工具专用 API Key 和模型 ID

1. 在控制台为该工具单独创建 API Key，不要与网站或其他工具共用同一把 Key。
2. 从模型文档进入目标详情，在“调用方式”确认工具所需接口已开放并复制模型 ID。
3. 确认账户余额充足，并使用对应协议的通用余额 Base URL。

3. 填写并验证

1. 在工具中选择 OpenAI Compatible、Anthropic Messages 或“自定义提供方”。
2. 粘贴教程对应的 Base URL，在凭据字段填写 API Key，再粘贴模型详情中已确认接口的模型 ID。
3. 保存后新建会话，发送不含敏感信息的最小请求。

如果新会话得到非空回复，并且界面显示 Token Factory 提供方和预期模型，这条路径就完成了。若失败，先检查 Base URL、Key 前后空格、模型 ID 和账户权益，再查看错误处理。