ttc

TokenHub Checker — 测试 TokenHub / 电信大模型网关 API Key 是否有效的命令行工具。

安装

npm install -g telecomjs-tokenhub-checker

用法

交互式测试

ttc

无参数时进入交互式流程：输入 API Key → 自动获取可用模型列表 → 选择模型 → 并行测试三种接口（chat-completion、responses、anthropic）并展示结果。

列出可用模型

ttc models <key>

输出 JSON 对象：

{
  "url": "https://aigw.telecomjs.com/v1/models",
  "models": ["deepseek-v3", "gpt-4o-mini", "glm-4.5"]
}

测试单接口

ttc test <key> [--chat | --anthropic | --responses] <model_name>

测试某个模型在指定接口下的回复是否正常，输出 JSON 对象：

{
  "key": "sk-xxxxxx",
  "model": "deepseek-v3",
  "content": "我是……",
  "valid": true,
  "url": "https://aigw.telecomjs.com/v1/chat/completions",
  "elapsed": "123.456ms",
  "type": "chat"
}

参数说明

| 参数 | 说明 | | ------------ | ----------------------------- | | key | API Key（必填） | | model_name | 模型名称（必填） | | --flag | 接口类型标志，默认为 --chat |

接口标志

| 标志 | 接口 | 端点 | | ---------------- | ------------------ | ---------------------- | | --chat（默认） | Chat Completions | /v1/chat/completions | | --responses | Responses | /v1/responses | | --anthropic | Anthropic Messages | /v1/messages |

标志和 model_name 顺序可互换：ttc test sk-xxx deepseek-v3 --anthropic 等效于 ttc test sk-xxx --anthropic deepseek-v3。 如果只传一个位置参数（无标志），该参数视为 model_name，接口默认为 --chat。

输出字段

| 字段 | 类型 | 说明 | | --------- | ------- | ---------------------------------------------- | | key | string | 本次使用的 API Key | | model | string | 测试的模型名称 | | content | string | 模型返回的内容（失败时为空字符串） | | valid | boolean | 请求是否成功且返回了有效内容 | | url | string | 实际请求的接口地址 | | elapsed | string | 请求耗时（如 123.456ms） | | type | string | 接口类型（chat / responses / anthropic） | | error | string | 仅在失败时出现，描述错误原因 |

usage 字段在单接口测试的输出中被移除，仅在交互模式的日志中展示。

环境变量

| 变量 | 默认值 | 说明 | | ----------------------- | ------ | ------------------------------------------------- | | TTC_MAX_OUTPUT_TOKENS | 300 | 最大输出 token 数，设置过小可能被截断导致响应异常 |

协议透传说明

电信大模型网关对三种接口均为透传。如果源供应商没有对应的接口（例如某些模型不支持 /responses 或 /messages），返回失败是正常现象。

License

MIT