STEP 01注册账户
- 点击网站右上角的 控制台,进入 TokenFactory 用户登录页。
- 输入你的邮箱和 12–200 位密码,首次使用点击 注册账户;已有账户点击 登录。
- 注册成功后,页面会显示你的邮箱、余额、API 密钥和余额流水。新账户初始余额为 $0。
打开用户控制台 ↗正式网址为 tokenfactoryapi.cc,请使用 HTTPS。验证码 60 秒后可重发,收不到时请检查垃圾邮件。
可用邮箱和密码注册,也支持 GitHub 登录。注册时请发送并填写 6 位邮箱验证码,验证码 10 分钟有效;忘记密码可通过邮箱重置。管理员后台是独立入口,普通用户不在那里注册。
STEP 02充值与查看余额
- 进入控制台的充值页面,选择至少 $5 的金额和已开放的币种、网络。
- 创建充值订单,按完整金额向指定网络的收款地址转账,网络手续费另付。
- 提交交易哈希 TxID 并核验;链上确认完成后自动入账,可在账户余额和余额流水中查看。
金额尾数用于区分订单,完整金额均计入余额;订单到期后请勿转账。新人首充赠送和邀请返利是否启用,以控制台显示的活动规则为准。账户按 USD 记账;充值按 1 USDT / USDC = 1 USD 入账,网络手续费另付。人民币报价按固定汇率 1 USD = 7 CNY换算,账单保留使用的汇率。
为什么余额够一次调用,却提示余额不足?
请求发出前会按模型最大上下文和本次输出上限预留费用,完成后按真实用量结算并释放余款。并发的每个请求分别预留;“可用余额”是账户余额减去预留金额。
模型按详情中展示的单价收费,缓存和长输入按对应档位计算。标注“价格待确认”的模型暂不开放用户付费调用。查看价格计算器 →
STEP 03创建并保存 API Key
- 在用户控制台找到 API 密钥,输入名称,例如“个人笔记本”或“聊天客户端”。
- 点击 创建密钥,复制弹窗内完整的
fr-… 密钥。 - 保存到对应客户端的 API Key 栏。完整密钥只展示一次;忘记时请新建并停用旧密钥。
每台设备或应用建议分别创建一把密钥。普通账户的所有密钥共享最多 8 并发,月套餐共享 16 并发。每分钟请求数仍按密钥配置,默认 60 次。创建更多密钥不会增加账户并发。
网站登录密码、TokenFactory API Key 和 ngrok Authtoken 是三种不同凭据。客户端只填写你在 TokenFactory 创建的 API Key。
STEP 04配置客户端
先选择一个已核价模型,例如 gpt-6.1-sol。同系列普通版与长上下文版已合并,默认使用最大可用上下文。直接复制目录中的模型 ID,不要填模型展示名称。
在支持自定义 API 的客户端中新增服务商,选择 OpenAI Compatible/OpenAI 兼容,填写下表。不同软件的菜单名称可能不同。
| 配置项 | 填写内容 |
|---|
| 服务商名称 | TokenFactory |
| API Base URL | |
| API Key | 你创建的 fr-… 完整密钥 |
| 模型 ID | gpt-6.1-sol |
| 请求协议 | Chat Completions |
| 流式输出 | 开启 |
Base URL 填到 /v1 即可。只有明确要求“完整请求 URL”的客户端才填写 /v1/chat/completions,避免重复拼接。
适用于已安装的 Codex CLI。编辑用户目录中的 ~/.codex/config.toml;Windows 通常为 %USERPROFILE%\.codex\config.toml。先备份已有文件,合并以下配置,避免重复同名字段或表。
config.toml
在启动 Codex 的同一个终端设置密钥,再运行 codex:
macOS / Linux · Bash / Zsh
export TOKENFACTORY_API_KEY='替换成你的完整API密钥'
codex
Windows · PowerShell
$env:TOKENFACTORY_API_KEY='替换成你的完整API密钥'
codex
这些环境变量只对当前终端及其子进程生效。桌面图标启动的 Codex 不一定继承它们。TokenFactory 当前未验证所有 Codex CLI 工具类型;如返回不支持的工具参数,可先用下方 cURL 验证模型通路,再联系管理员排查客户端兼容性。
OpenAI 官方配置参考 ↗
适用于已安装的 Claude Code。在 ~/.claude/settings.json 中合并下面配置,替换密钥占位符。已有的同名配置应修改,不要重复添加。
settings.json
保存后重新启动 Claude Code,发送一条简短消息。示例使用 Messages 协议访问 gpt-6.1-sol,客户端名称不代表模型一定是 Claude。
该文件包含密钥,请勿提交到 Git 或分享。原有环境变量若指向其他服务,需先处理冲突。仅改 Base URL 而不设置 TokenFactory 密钥无法完成认证。
Claude Code 官方网关文档 ↗
STEP 05测试第一次请求
macOS/Linux 终端使用下方命令。Windows 建议使用 WSL/Git Bash 执行相同示例。将 YOUR_API_KEY 替换为你创建的密钥。
Chat Completions · 流式请求
成功时会看到多行 data: 内容和最终的 [DONE]。随后回到控制台查看余额流水;余额可能因预留与结算而短暂变化。
查看可用模型列表
GET /v1/models
模型目录可列出尚待核价的模型。能列出模型不代表你的付费账户已获准调用该入口。
常见问题
登录页打不开,或出现 ngrok 提示
普通 ngrok 提示页在确认地址后点击 Visit Site。若显示 tunnel offline、连接超时或网关错误,联系管理员检查服务机网络、运行状态和隧道。网站目录与模型网关是不同服务,目录能打开不代表 API 一定在线。
401:认证失败
检查是否复制了完整 API Key、是否含多余空格,以及密钥是否已停用或过期。不要把账户登录密码或 ngrok 令牌填入 API Key。
402:余额不足
在控制台充值,并检查可用余额和请求预留。已充值但仍不足时,可降低 max_tokens/max_completion_tokens,或等待其他请求完成释放预留。
403:模型或工具不支持
检查模型是否标注价格待确认,或密钥是否限制了模型范围。付费接口目前只支持客户端函数工具,不支持内置收费搜索、图像生成工具或自定义服务档位。
404:地址或接口不正确
确认 API Base URL 使用控制台展示的地址并以 /v1 结尾,不是本网站目录地址,也不是管理员登录页或 /market。检查客户端是否重复添加 /v1。
429:并发或频率超限
普通账户共享最多 8 并发,月套餐共享 16 并发;每密钥默认 60 次/分钟。停止重复重试,等待已有请求完成,按 Retry-After 提示再试。上游模型服务也可能独立限流,提升中转站设置不保证提升上游容量。
没有收到完整回答,或 502/503
可能是上游排队、网络中断或模型服务错误。保存错误提示、时间和响应头中的 x-request-id 供管理员查询,不要把完整密钥贴进截图。
登录密码或 API Key 丢失了
API Key 无法再次查看完整值,可在控制台创建新密钥并停用旧密钥。启用邮件服务后可通过邮箱重置密码;否则请联系管理员处理。
如何确认实际费用?
模型详情与费用计算器展示本站实际单价。账户按 USD 记账;监控金额按每笔账单的汇率折算为人民币,可在请求详情中核对。