🧩 VoiceMind Platform — ядро

• Единая шина для LLM: маршрутизация, параллельные запросы, fallback, логирование
• Очереди задач и оркестрация генераций (изображения / видео / озвучка)
• Статистика, биллинг токенов, тарифы и квоты по проектам
• Роли ассистентов, пресеты, многошаговые сценарии

🏗️ Архитектура (высокоуровнево)

• Gateway: приём запросов, аутентификация, квоты
• Router: выбор модели(ей) по правилу / стоимости / скорости
• Workers: исполнение задач (LLM, TTS, STT, image/video)
• Storage & Logs: файлы, версии, аудит, метрики

🔌 Интеграции

• Webhook-и для входящих/исходящих событий
• Плагины: n8n / Make / Zapier (в разработке)
• Подключение собственных провайдеров LLM через адаптер
• Экспорт метрик в Prometheus/Grafana (roadmap)

🛡️ Операции и безопасность

• Изоляция проектов и API-ключей, ролевая модель доступа
• Шифрование в транзите (TLS) и в хранилище
• Masking/редакция персональных данных (PII)
• SLA и алерты на деградацию провайдеров

🏢 B2B-кейсы

• Внутренние ассистенты и helpdesk
• Контент‑фабрики (текст/арт/видео)
• RAG/поиск по знаниям компании

💳 Доступ и тарифы

• Free (ограниченные квоты) — для тестирования
• Pro — повышенные лимиты, приоритетные очереди
• Enterprise — SSO, приватные провайдеры, SLA

Пока идёт ранний доступ. Напишите нам — подберём условия.

🔬 Как это работает (Deep dive)

Проекты/ключи → роутер → очереди → воркеры → вебхуки/логирование.

🧭 Управление и биллинг

🚀 Развёртывание

✅ Безопасность и соответствие

🛎️ SLA и поддержка

🤝 Партнёрская программа

⚡ Quickstart (5 минут)

Получите ключ → отправьте первый запрос → обработайте ответ.

curl -H "Authorization: Bearer $VM_API_KEY" -H "Content-Type: application/json" \
  -d '{"models":["gpt-4o"],"input":"Hello"}' https://voicemind.tech/api/v1/chat

await fetch('/api/v1/chat', {method:'POST', headers:{'Authorization':`Bearer ${VM_API_KEY}`,'Content-Type':'application/json'}, body:JSON.stringify({models:['gpt-4o'],input:'Hello'})});

import requests, os
r=requests.post('https://voicemind.tech/api/v1/chat', headers={'Authorization':f"Bearer {os.environ['VM_API_KEY']}",'Content-Type':'application/json'}, json={'models':['gpt-4o'],'input':'Hello'})
print(r.json())

📦 Версионирование API

• Стабильные и экспериментальные флаги
• Политика breaking‑changes с уведомлениями

🛠️ Примеры интеграций

• n8n / Make / Zapier — ноды и webhooks
• AWS Lambda / FastAPI
• Next.js server actions

🔐 Безопасность API

• Ключи, ротация, ограничение областей (scopes)
• Best practices хранения секретов

🔗 Обзор API

• POST /api/v1/chat — чат/комплишн (multi‑LLM)
• POST /api/v1/images.generate — генерация изображений
• POST /api/v1/images.edit — редактирование/инпейнт
• POST /api/v1/speech.tts — озвучка текста
• POST /api/v1/speech.stt — распознавание речи
• GET /api/v1/jobs/{id} — статус задач

Аутентификация: Authorization: Bearer <vm_api_key>

💬 Пример: чат (curl)

curl -X POST https://voicemind.tech/api/v1/chat \
  -H "Authorization: Bearer $VM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "models": ["gpt-4o", "gemini-2.0-flash"],
    "role": "analyst",
    "input": "Сделай сводку по продажам за август",
    "attachments": ["https://.../report.xlsx"]
  }'

await fetch('/api/v1/chat', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${VM_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ models: ['gpt-4o','gemini-2.0-flash'], role: 'analyst', input: 'Сводка по продажам за август' })
});

import requests, os
r = requests.post('https://voicemind.tech/api/v1/chat',
  headers={'Authorization': f"Bearer {os.environ['VM_API_KEY']}", 'Content-Type':'application/json'},
  json={ 'models':['gpt-4o','gemini-2.0-flash'], 'role':'analyst', 'input':'Сводка по продажам за август' })
print(r.json())

🖼️ Пример: генерация изображений

POST /api/v1/images.generate
{
  "model": "sdxl-turbo",
  "prompt": "isometric office, neon, night",
  "steps": 12,
  "size": "1024x1024"
}

Асинхронные задачи возвращают job_id; статус — через GET /api/v1/jobs/{id} или через вебхук.

📬 Webhook-и

• События: job.completed, job.failed, quota.exceeded
• Формат: подписанный JSON, повтор доставки с экспоненциальной задержкой
• Безопасность: подпись HMAC-SHA256, привязка к проекту

🧰 SDK и инструменты

• JavaScript/TypeScript SDK (скоро)
• Python SDK (скоро)
• OpenAPI: /docs (Redoc)
• Коллекция Postman и OpenAPI-спека

🔐 Авторизация и медиа

• Authorization: Bearer <vm_api_key> — доступ ко всем API
• Медиа: загрузки с проверкой ClamAV, ссылки S3/MinIO
• Идемпотентность: ключи вида tts:*, usage:*

📈 Лимиты и квоты

• Rate limit по ключу и проекту
• Квоты на модели/провайдеров
• При превышении — понятные ошибки и вебхук quota.exceeded