UnlimitedTTS для агентов

Неконсорциальный, ориентированный на котировки синтез речи для ИИ-агентов:

• @unlimitedtts/core проверяет живые x402-челленджи, применяет политику расходов, сохраняет санитизированные квитанции и записывает приватные MP3-артефакты.

• @unlimitedtts/mcp предоставляет инструменты tts_list_voices, tts_quote и необратимый tts_synthesize через stdio.

• @unlimitedtts/openclaw объединяет MCP-сервер и навык агента unlimitedtts.

• skills/unlimitedtts поддерживает MCP-управляемые и прямые HTTP-процессы с поддержкой кошелька.

Реализованный путь v1 — режим внешней подписи. Отдельный инструмент кошелька создает x402 v2 PAYMENT-SIGNATURE; этот код никогда не принимает seed-фразу или приватный ключ.

Установка и сборка

Требуются Node.js 20 или новее и pnpm.

pnpm install --frozen-lockfile
pnpm check

Запустите локальный сервер из этого репозитория:

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

Общая конфигурация MCP после публикации в npm:

{
  "mcpServers": {
    "unlimitedtts": {
      "command": "npx",
      "args": ["-y", "@unlimitedtts/mcp@0.1.0"],
      "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

Related MCP server: mcp-ai-voice

Платежный процесс

1. tts_list_voices получает /docs и /tts/voices и кэширует результат на пять минут.

2. tts_quote отправляет точное тело синтеза на /x402/tts без оплаты, проверяет возвращенный PAYMENT-REQUIRED, применяет локальную политику, резервирует скользящий бюджет и возвращает кратковременный HMAC-токен.

3. Кошелек подписывает только возвращенный selectedRequirement.

4. tts_synthesize проверяет токен, неизмененный хэш тела, полную запись accepted x402 v2, точного получателя и сумму в EVM, затем отправляет одну платную попытку.

5. Успешный вызов требует как audio/mpeg, так и PAYMENT-RESPONSE. Он фиксирует бюджет, записывает санитизированную квитанцию, атомарно сохраняет MP3 с режимом 0600 и возвращает структурированные метаданные плюс MCP-аудио/ресурсный контент.

PAYMENT_OUTCOME_UNKNOWN навсегда помещает эту котировку в локальный реестр. Сервер никогда автоматически не отправляет и не авторизует второй платеж.

Конфигурация

Ротация получателей должна выпускаться через доверенную конфигурацию. Сервер никогда не узнает разрешенного получателя из недоверенного челленджа.

Производственная среда остается по умолчанию и привязана к Base mainnet. Для проверки staging установите UNLIMITEDTTS_ENVIRONMENT=staging; это выбирает https://staging-api.unlimitedtts.com, Base Sepolia (eip155:84532) и staging USDC. Ядро отклоняет staging-источник, сеть или актив, если среда явно не staging.

Область применения

Этот репозиторий реализует портативный локальный MCP, контракт адаптера внешнего кошелька, навык агента, пакет OpenClaw, тесты и метаданные реестра. Размещенный Streamable HTTP, временное хранилище R2, синтез по предоплаченным картам и конкретный управляемый автоматический подписант намеренно не рекламируются как завершенные функции v1.

См. требуемые и рекомендуемые изменения в вышестоящем API перед включением автоматической подписи без присмотра или размещенного сервиса.