UnlimitedTTS

エージェント向け UnlimitedTTS

AI エージェント向けの、カストディ不要で見積もりを優先するテキスト読み上げです。

• @unlimitedtts/core は、進行中の x402 チャレンジを検証し、支出ポリシーを適用し、サニタイズ済みのレシートを永続化して、非公開の MP3 アーティファクトを保存します。
• @unlimitedtts/mcp は、stdio 経由で tts_list_voices、tts_quote、取り消し不可能な tts_synthesize ツールを公開します。
• @unlimitedtts/openclaw は、MCP サーバーと unlimitedtts エージェントスキルをまとめて提供します。
• skills/unlimitedtts は、MCP のガイド付きワークフローと、ウォレットを考慮した直接の HTTP ワークフローに対応します。

実装済みの v1 経路は外部署名モードです。別のウォレットツールが x402 v2 の PAYMENT-SIGNATURE を作成します。このコードがシードフレーズや秘密鍵を受け取ることはありません。

インストールとビルド

Node.js 20 以降と pnpm が必要です。

pnpm install --frozen-lockfile
pnpm check

このチェックアウトからローカルサーバーを実行します。

pnpm --filter @unlimitedtts/mcp build
node packages/mcp/dist/cli.js

npm 公開後の汎用 MCP 設定：

{
  "mcpServers": {
    "unlimitedtts": {
      "command": "npx",
      "args": ["-y", "@unlimitedtts/[email protected]"],
      "env": {
        "UNLIMITEDTTS_MAX_USDC_PER_CALL": "0.10",
        "UNLIMITEDTTS_ROLLING_24H_USDC": "1.00",
        "UNLIMITEDTTS_OUTPUT_DIRECTORY": "/absolute/approved/output"
      }
    }
  }
}

OpenClaw のローカル開発：

pnpm --filter @unlimitedtts/openclaw build
openclaw plugins install -l ./packages/openclaw
openclaw plugins enable unlimitedtts
openclaw gateway restart
openclaw plugins inspect unlimitedtts --runtime --json
openclaw plugins doctor

支払いフロー

1. tts_list_voices は /docs と /tts/voices を取得し、結果を 5 分間キャッシュします。
2. tts_quote は、支払いなしで正確な音声合成リクエスト本文を /x402/tts に送信し、返された PAYMENT-REQUIRED を検証してローカルポリシーを適用し、ローリング予算を確保して、有効期間の短い HMAC トークンを返します。
3. ウォレットが署名するのは、返された selectedRequirement のみです。
4. tts_synthesize はトークン、変更されていない本文のハッシュ、完全な x402 v2 accepted エントリー、正確な EVM の受取人と金額を検証し、有料リトライを 1 回送信します。
5. 呼び出しを成功とするには、audio/mpeg と PAYMENT-RESPONSE の両方が必要です。予算を確定し、サニタイズ済みのレシートを書き込み、モード 0600 で MP3 をアトミックに保存して、構造化メタデータと MCP の音声／リソースコンテンツを返します。

PAYMENT_OUTCOME_UNKNOWN が発生した場合、その見積もりはローカル台帳で恒久的に隔離されます。サーバーが 2 回目の支払いを自動送信または承認することはありません。

設定

環境変数	デフォルト
UNLIMITEDTTS_ENVIRONMENT	production。ステージング API と Base Sepolia を使うには、明示的に staging を設定します
UNLIMITEDTTS_API_ORIGIN	https://api.unlimitedtts.com
UNLIMITEDTTS_ALLOWED_NETWORKS	eip155:8453
UNLIMITEDTTS_ALLOWED_ASSETS	Base USDC コントラクト
UNLIMITEDTTS_ALLOWED_PAYEES	2026 年 7 月 30 日の検証済みリリースコントラクトから固定された受取人
UNLIMITEDTTS_MAX_USDC_PER_CALL	0.10
UNLIMITEDTTS_ROLLING_24H_USDC	1.00
UNLIMITEDTTS_APPROVAL_THRESHOLD_USDC	0.05
UNLIMITEDTTS_REQUIRE_APPROVAL	first-payment-and-over-threshold
UNLIMITEDTTS_OUTPUT_DIRECTORY	サーバーの作業ディレクトリ内の .unlimitedtts-artifacts
UNLIMITEDTTS_QUOTE_TOKEN_SECRET	プロセスごとにランダムに生成されます。複数インスタンスをデプロイする場合はシークレットを設定してください

受取人のローテーションは、信頼できる設定を通じてリリースする必要があります。サーバーが信頼できないチャレンジから許可された受取人を学習することはありません。

デフォルトは本番環境で、Base メインネットに固定されています。ステージングで検証するには、UNLIMITEDTTS_ENVIRONMENT=staging を設定します。これにより、https://staging-api.unlimitedtts.com、Base Sepolia（eip155:84532）、ステージング用 USDC が選択されます。環境が明示的に staging でない場合、コアはステージングのオリジン、ネットワーク、アセットを拒否します。

対象範囲

このチェックアウトには、ポータブルなローカル MCP、外部ウォレットアダプターの契約、エージェントスキル、OpenClaw パッケージ、テスト、レジストリメタデータが実装されています。ホスト型 Streamable HTTP、一時的な R2 ストレージ、プリペイドカードによる音声合成、具体的なマネージド自動署名機能は、意図的に v1 で完成済みの機能として案内していません。

自動署名を無人で有効にする前、またはホスト型サービスを提供する前に、上流 API に必要な変更と推奨される変更を参照してください。