voice-quality-api

音声品質 API

音声／VoIP 宛先までのネットワーク経路品質を測定し、推定 MOS（1～5）を API からリアルタイムで取得できます。 AI 音声エージェント向けに構築されています。REST と MCP ツールとして利用でき、x402（Base 上の USDC）で呼び出しごとに支払います。

🌐 ライブ版： voice-quality.com · REST api.voice-quality.com · MCP mcp.voice-quality.com

---

お試しください

curl https://api.voice-quality.com/health          # {"status":"ok"}

curl -s https://api.voice-quality.com/v1/voice-quality \
  -H 'content-type: application/json' \
  -d '{ "target": "your-voice-endpoint.example", "target_port": 10000, "codec": "G711" }'

推定 MOSと、リアルタイムのRTT／ジッター／パケット損失を取得できます。メディアに応答するエンドポイントを指定してください。独自の音声インフラ、または自分で実行する小さなリフレクターが利用できます（probe-agent/cmd/reflector）。1 日 20 回まで無料です。それを超えると、x402 による呼び出しごとの支払いが必要です（アカウント不要）。

{
  "request_id": "vq_2ibc6qqq",
  "target": "your-voice-endpoint.example",
  "codec": "G711",
  "measured_at": "2026-07-01T10:15:13.795Z",
  "summary": { "mos_estimate": 4.38, "mos_class": "excellent", "r_factor": 91.8 },
  "by_probe": [ /* per-probe metrics + R-factor + MOS */ ],
  "methodology": {
    "model": "ITU-T G.107 E-model",
    "confidence": "estimate",
    "assumptions": ["owd = rtt/2 (symmetric path)", "adaptive jitter buffer = 2x jitter"]
  },
  "credits_used": 0
}

開発の背景

無料のネットワーク測定プラットフォーム（Globalping、RIPE Atlas）は、ping／traceroute／DNS／HTTP を測定しますが、RTP メディア品質の測定や MOS の推定は行いません。それらを行うツール（Cyara、Spearline）は、エンタープライズ向けの営業を前提としています。本プロジェクトはそのギャップを埋め、音声経路品質を、使いやすくセルフサービス可能なエージェントネイティブの API として提供します。通話のルーティング前の確認や、音声エンドポイントへの経路の監視にご利用ください。

信頼性を重視した設計

• 指標を正直に提示。 測定したネットワーク指標に基づく 客観的な G.107 E-model の推定値です。知覚品質スコア（PESQ／POLQA）として販売することはありません。すべての応答には methodology.confidence: "estimate" と、その前提条件が含まれます。
• 定数を検証済み。 コーデックの Ie／Bpl 値は ITU-T G.113（09/2024）、App. I、Table I.4 と照合して検証済みです。プローブプロファイル（PLC なし、VAD／DTX なし）に該当する行を照合しています。「代表値」ではなく、出典を明記しています。
• SSRF 対策済み。 公開 MCP サーバーのおよそ 36.7% に SSRF の問題があります。このサーバーでは、デフォルトで内部／プライベート宛先をブロックします（オーケストレーターとプローブの両方）。さらに、宛先ごとの許可リストとレート制限を備えています。
• 堅牢化済み。 プローブチャネルでの TLS／mTLS、非 root コンテナー、問題のない pnpm audit、機械可読な構造化エラー、Idempotency-Key、Prometheus /metrics、ID ごとの API キーに対応しています。

料金

プラン	内容
無料	ID ごとに 1 日 20 回の測定（credits_used: 0）。
呼び出しごとの支払い	それを超える場合、x402（Base 上の USDC）で呼び出しごとに 1 セント未満～数セントの少額決済が発生します。未払いの場合は、支払い要件を含む 402 が返されます。支払って再試行してください。エージェントによる支払いは透過的に行われます。

エージェントネイティブ（MCP + x402）

MCP ツールは measure_voice_quality の 1 つです。サーバーは REST API をラップし、無料枠を使い切ると設定済みのウォレットから x402 で透過的に支払うため、処理に人が介在する必要はありません。

{
  "mcpServers": {
    "voice-quality": {
      "url": "https://mcp.voice-quality.com/",
      "env": { "MCP_CLIENT_PRIVATE_KEY": "0x…" }   // optional; only for paid calls
    }
  }
}

アーキテクチャ

[AI agent / dev] ──(HTTP + x402 / MCP)──► [Orchestrator] ──► [E-model (G.107): R → MOS]
                                              └──► [regional probe] ──(emulated UDP/RTP)──► target

コンポーネント	スタック	役割
オーケストレーター (packages/orchestrator)	TypeScript + Hono	REST API、E-model、x402 のペイウォール、AUP、レート制限、プローブへのディスパッチ
MCP サーバー (packages/mcp-server)	TypeScript + MCP SDK	measure_voice_quality。REST をラップし、x402 による支払いを透過的に処理
プローブエージェント (probe-agent)	Go	UDP／RTP エミュレーション + RFC 3550 メトリクス。低コストのリージョナル VPS
共有 (packages/shared)	TypeScript	Zod スキーマ、型、G.113 のコーデック定数

セルフホスト

cp .env.example .env                 # fill in values
docker compose up --build -d         # orchestrator + MCP + probe + reflector + landing
curl localhost:8080/health

本番環境への完全なデプロイ（Caddy または Cloudflare Tunnel を使った公開 HTTPS、mTLS 対応のリージョナルプローブ）については、docs/deploy.md をご覧ください。本番運用（x402 メインネット、コーデック検証、レジストリ）については、docs/go-live.md をご覧ください。

ドキュメント

方法論 · OpenAPI · デプロイ · 本番稼働 · ディスカバリーとレジストリ

---

MOS はネットワークの状態に基づく客観的な推定値であり、通話品質を保証するものではありません。積極的にメンテナンスされています。