给 Agent 用 — TokenToken

完整闭环

读目录、算价、调用、对账——然后被我们强制的额度停住。

额度挂在 key 上，不在 Agent 的 prompt 里。跑飞的循环会用光额度，而不是刷出一张账单。

装一个 skill

Claude Code / Agent SDK

curl -fsSL https://tokentoken.ai/\
skills/tokentoken.zip -o s.zip
unzip s.zip -d ~/.claude/skills/

告诉 Agent base_url、模型 id、怎么读价目表，以及怎么把自己控制在额度之内。

MCP server

{
  "tokentoken": {
    "command": "npx",
    "args": ["-y","@tokentoken/mcp"],
    "env": {"TT_API_KEY":"tt-..."}
  }
}

提供目录查询、成本预估、用量查询与 key 轮换这几个工具。

给爬取方的站点索引

GET /llms.txt
GET /llms-full.txt
GET /.well-known/ai-plugin.json

本站每个页面都有纯文本版本，Agent 读我们的文档不必解析 HTML。

skill 包与 MCP 包随 API 一起发布。需要我们还没提供的格式，写信 support@cflabs.ai。

Agent 真正需要的端点

端点	Agent 要它干什么
GET /v1/models	这把 key 实际能调的模型，带上下文长度、模态与来源标签
GET /v1/pricing	当前价格与 rate 系数，带版本号可以 pin
POST /v1/cost/estimate	调用之前先算这次要花多少钱——在预算内做规划
GET /v1/usage	按 key、模型、按天的消费与 token 数
GET /v1/balance	剩余额度，以及当前被在途请求预扣冻结的部分
POST /v1/chat/completions	OpenAI 兼容，支持流式与工具调用
POST /v1/messages	Anthropic Messages，同一把 key

让 Agent 自主花钱的闸门

Agent 绕不过去的限制，因为由我们强制执行。

每把 key 的消费上限，到顶就停，不透支
每把 key 的模型白名单，Agent 不会误跑到贵线路上
RPM、TPM 与并发上限，超限返回 429 并带 Retry-After
有效期，交给某次实验的 key 会自己失效
余额不足在上游调用之前就返回 402，不会在流中途断
每个响应都带 request id，能把这次调用对到账单的那一行

# 一个 Agent 一把 key，限定范围与额度
POST /v1/keys
{
  "name": "research-agent",
  "models": ["tt/glm-5.3"],
  "quota_usd": 25,
  "rpm": 120,
  "expires_at": "2026-12-01"
}

# 只显示一次，库里只存哈希
{ "key": "tt-live-...", "prefix": "tt-...a91f" }