SmartTokenGuard

SmartTokenGuard

English · 简体中文

别再为有问题的 AI 视频白白烧钱。

每个黑帧、静止画面和偏离模型设定的关键帧，都在浪费你已经付出的钱。SmartTokenGuard 会在 ComfyUI、Kling、Runway、Veo、Hailuo、Seedance 或任何其他 AI 视频工具完成渲染的那一刻，检查其中的每个关键帧和片段，并告诉你的 AI 助手是否值得继续为下一步付费：通过、根据具体修正意见重试、切换模型，或停止为该镜头花钱。

有问题的渲染让你损失了多少钱？ 试试计算器：https://nwjnjjj.github.io/smart-token-guard/

工具	功能
stg_inspect_render	检测图像或视频：模糊和柔焦、曝光过度／不足、黑帧、静止片段、闪烁、硬切、冲击和闪光，以及与参考图相比的色彩／光照偏移。返回供助手检查手部、面部和身份的审查帧。
stg_qa_gate	将测得的问题与助手观察到的情况转化为 PASS / RETRY_SAME_MODEL / SWITCH_TO_FALLBACK / HALT / HALT_BUDGET，并给出具体修正方案（负面提示词、降低运动幅度、新种子）。在你的电脑上按项目记录支出。
stg_detect_events	精确定位冲击、闪光和切换的帧，用于放置音效。
stg_spend_report	显示项目支出、每个通过镜头的尝试次数、首次尝试通过率，以及付费生成视频前被拒绝的关键帧。
stg_account、stg_pricing	许可证用量和套餐。

先检查关键帧。 被拒绝的静帧不花钱。被拒绝的 5 秒片段，费用已经付过了。

判定方式：自动运行检测，并由助手检查返回帧中的手部、面部和身份，然后渲染结果才能判定为 PASS，因此有问题的内容不会进入下一步付费流程。

套餐

套餐	按月付费	按年付费	每月检查次数
Starter	US$9	US$99	300
Pro	US$29	US$290	3,000

检查次数每月 1 日（UTC）重置。每人一个许可证；团队需为每位成员购买一个许可证。结账、税费和发票由名义商家 Polar 处理。Polar 收据中的许可证密钥就是你的 API 密钥。 在 Polar 客户门户中取消或更改套餐。运行 stg_pricing 获取结账链接。

安装（MCP）

需要 uv。

Claude Desktop / Cursor：添加到 claude_desktop_config.json 或 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "smart-token-guard": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/nwjnjjj/smart-token-guard", "smart-token-guard"],
      "env": { "STG_LICENSE_KEY": "your-license-key" }
    }
  }
}

Claude Code

claude mcp add smart-token-guard -e STG_LICENSE_KEY=your-license-key -- uvx --from git+https://github.com/nwjnjjj/smart-token-guard smart-token-guard

VS Code：.vscode/mcp.json → {"servers": {"smart-token-guard": {"type": "stdio", "command": "uvx", "args": [...same...], "env": {...}}}}

然后询问：“检查 renders/sh010_keyframe.png 与 refs/kai.png 是否一致。如果通过，我会在 Kling 上渲染片段（0.7 USD，备用模型为 Runway）。”

Python SDK

pip install git+https://github.com/nwjnjjj/smart-token-guard

from smart_token_guard import Client

stg = Client()  # reads STG_LICENSE_KEY
report = stg.inspect("renders/sh010.mp4", reference_image="refs/kai.png")
print(report["report"]["issues"], report["license"]["checks_remaining"])

decision = stg.qa_gate(model="Kling", render_cost_usd=0.7, technical_issues=report["report"]["issues"],
                       semantic_defects=["deformed_hands"], fallback_model="Runway")
print(decision["decision"], decision["actions"])

HTTP API：POST /v1/inspect（multipart file，可选 reference、options JSON）、POST /v1/qa-gate、使用 Authorization: Bearer <license key> 的 GET /v1/account。参见 GET /v1/capabilities。

面向 AI Agent（远程 MCP 和 A2A）

无需安装。媒体通过公共 https URL 传递；服务会下载、分析并删除媒体。

• 远程 MCP（Streamable HTTP）： https://stg-agent-560636228350.asia-east1.run.app/mcp，需提供标头 Authorization: Bearer <license key>。工具：stg_inspect_media_url、stg_qa_gate、stg_account、stg_pricing。
• A2A： Agent Card 位于 https://stg-agent-560636228350.asia-east1.run.app/.well-known/agent-card.json，JSON-RPC message/send 位于 /a2a。发送数据部分 {"media_url": "https://..."}（或包含链接的文本）以进行检查， 或发送 {"skill": "qa-gate", ...} 获取判定。
• 套餐和每月检查次数与上文相同。URL 必须指向公共 https 主机；不接受私有地址和内部地址。

限制与隐私

• 每个文件最多 32 MB、时长 60 秒、分辨率 1080p（JPEG、PNG、WebP、MP4、MOV、WebM、MKV）。每分钟最多 30 次请求。
• 文件会上传到 SmartTokenGuard API（Google Cloud），在临时文件中进行分析，并且会在发送响应前删除。不会存储任何内容，也不会将任何内容用于训练。
• API 会收到你的许可证密钥和文件。项目账本保留在你的计算机上（~/.smart-token-guard/）。
• 测量检查可捕获技术渲染失败，但不认证解剖结构、身份、版权或故事质量。

支持

退款、发票和取消订阅：Polar 客户门户（链接见收据）。 此仓库中的客户端代码采用 MIT 许可证；托管 API 需要付费许可证。