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）にリセットされます。ライセンスは1人につき1つ必要です。チームの場合はメンバーごとに購入してください。決済、税金、請求書は、販売事業者として 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 エージェント向け（リモート 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）。1 分あたり 30 件までリクエストできます。
• ファイルは SmartTokenGuard API（Google Cloud）にアップロードされ、一時ファイルで分析され、レスポンスが送信される前に削除されます。保存されることはなく、トレーニングにも使用されません。
• API はライセンスキーとファイルを受信します。プロジェクト台帳はお使いのコンピューター（~/.smart-token-guard/）に保存されます。
• 測定に基づくチェックでは、技術的なレンダリングの失敗を検出します。解剖学的な正確さ、本人確認、著作権、ストーリーの品質を認証するものではありません。

サポート

返金、請求書、解約については、Polar のカスタマーポータル（領収書に記載のリンク）をご利用ください。 このリポジトリのクライアントコードは MIT ライセンスですが、ホスト型 API の利用には有料ライセンスが必要です。