TokenAPI Scan — For Agents & Tools

TokenAPI Scan（Token 照妖镜）是 AI API 中转站（OpenAI / Anthropic / Gemini 兼容代理）的独立第三方监测与排行服务。所有端点只读 JSON、无需注册、无需 key、MIT 开源。数据行带 provenance（source / method / fetched_at / evidence_ref）。

五分钟上手

curl -sS "https://tokenscanai.com/api/router/candidates?model=claude-sonnet-4-5&limit=5" | jq
curl -sS "https://tokenscanai.com/api/trust/provider/openrouter" | jq
curl -sS "https://tokenscanai.com/data/relay-catalog.json" | jq '.providers | length'

端点一览

方法	端点	说明
`GET`	`/api/_meta`	服务自描述：版本、协议、端点链接
`GET`	`/api/router/candidates?model={model_id}&limit=N`	选路情报：某模型各服务商实时价格、endpoint、评分与推荐角色（主路/备路/观察/避开）
`GET`	`/api/trust/provider/{provider_id}`	单服务商信任原语：加密验证 trust 等级（high/medium/low）、success 率、检测次数、evidence 句柄
`GET`	`/api/trust/providers?ids=a,b,c`	批量信任原语：一次取多个服务商的信任维度
`GET`	`/api/evidence/{provider_id}`	证据原语：最近一次 L1 探测的可复核证据（内容寻址 sha256）
`GET`	`/api/prices`	价格数据
`GET`	`/api/site/{site_id}`	服务商档案数据
`GET`	`/data/relay-catalog.json`	全量中转信任+价格目录（224 家，含 trust 等级/evidence/最低价），适合外部引用
`GET`	`/openapi.json`	OpenAPI schema（31 个端点）
`GET`	`/llms.txt`	GEO 入口：面向 AI 引擎的站点与接口说明
`GET`	`/.well-known/agent.json`	A2A AgentCard
`GET`	`/.well-known/ai-plugin.json`	Plugin manifest

工具 API：模型指纹验证（/tools/model-fingerprint）

把工具指向任意 OpenAI 兼容端点，用它声称的模型名跑一组低成本行为探测，与参考指纹库对比后给出判定；另有 glitch token 探测给分词器血统/掺水线索。公共模式只返回判定与通俗解释（方法学参数仅在完整版开放），公网限频 6 次/小时/IP，Key 不落盘。

# 1) 提交一次快速验证（360 次探测，约 3-4 分钟）→ 返回 job_id
curl -sS -X POST "https://tokenscanai.com/tools/api/model-fingerprint/verify"   -H 'Content-Type: application/json'   -d '{"base_url":"https://api.example.com/v1","api_key":"sk-…","model":"claude-opus-4-5","quick":true}'
# 2) 轮询判定
curl -sS "https://tokenscanai.com/tools/api/model-fingerprint/status/<job_id>"
# 3) glitch token 探测（分词器血统线索）
curl -sS -X POST "https://tokenscanai.com/tools/api/model-fingerprint/glitch"   -H 'Content-Type: application/json'   -d '{"base_url":"https://api.example.com/v1","api_key":"sk-…","model":"gpt-4o","limit":40}'
# 4) 公共检测记录（脱敏：端点域名 + 声称模型 + 判定，最新 50 条）
curl -sS "https://tokenscanai.com/tools/api/model-fingerprint/records?limit=20"

数据字典：核心端点字段

GET /api/router/candidates — 选路情报

字段	类型	说明
resolved_model	string	解析后的 canonical 模型 id（别名自动归一）
price_provider_count	int	全网有该模型渠道价的 provider 数
candidates[].price	object	input/output_usd_per_1m + source（价格来源 URL）+ fetched_at（采集时间）
candidates[].scores	object	total/cost/integrity/availability/coverage/risk，0-100
candidates[].recommended_role	enum	primary（主路）/ fallback（备路）/ watch（观察）/ avoid（避开）
candidates[].risk_flags	string[]	low_detection_sample / low_pass_rate / framework_dead / missing_price_source
candidates[].evidence	object	五维评分的原始依据（价格区间/协议通过数/探测通过率等），可独立复核
generated_at	string	本次计算时间（RFC3339 +08:00）
license	string	CC-BY-4.0；引用请注明 "TokenAPI Scan (tokenscanai.com)"

GET /api/trust/provider/{provider_id} — 信任原语

字段	类型	说明
trust.verified	enum	high（success≥0.9）/ medium（≥0.7）/ low / null（无数据）
trust.success_rate	float	加密/行为探测成功率（0-1）
trust.detection_count	int	累计探测次数
trust.latest_detected_at	string	最近一次探测时间（UTC）
levels	object	各探测等级次数分布（L1=深度验证 / health=连通性）
evidence	string	evidence:// 证据句柄，可内容寻址独立验证

GET /api/evidence/{domain} — 证据原语

按域名返回最近一次 L1 探测的内容寻址证据（sha256 + 原始探测记录），第三方可独立复核"这个 trust 结论确实来自这些客观探测"。当前索引含 753 个域名的证据。

# 真实样例（截取）
curl -sS "https://tokenscanai.com/api/evidence/88api.ai"
{ "status": "ok", "provider_id": "88api.ai",
  "sha256": "…", "checked_at": "…", "verifiable": true,
  "evidence": { "domain": "88api.ai", "homepage_ok": true,
    "models_endpoint_ok": true, "models_count": 87, … } }

数据授权 / Pilot

需要更高频刷新、更长历史、批量全量导出或商用授权（Router Intelligence Feed：candidates + trust + evidence 打包订阅）？我们开放限量 free pilot（4 周，面向 AI gateway / agent / 路由工具团队），换取接入反馈。联系：[email protected]（注明团队/用例/期望 QPS）。引用公开数据请遵守 CC-BY-4.0 并署名 TokenAPI Scan。

自描述发现入口

agent 客户端按优先级探索：/.well-known/agent.json（A2A AgentCard）→ /.well-known/ai-plugin.json → /openapi.json → /llms.txt。

契约承诺：公开字段只增不删；错误体统一 snake_case code；服务自描述见 /api/_meta。