Werty / Documentation

Ваши инструменты.
Один ключ.

Выберите приложение и настройте подключение. Здесь указаны и рабочие примеры, и ограничения текущего API.

Начало

  1. Создайте аккаунт и подтвердите email.
  2. Сохраните ключ в разделе «API keys» и пополните баланс.
  3. Используйте base URL ниже. Идентификаторы доступных моделей можно получить запросом GET /v1/models с вашим Bearer-ключом.
ПАРАМЕТРЫ
Base URL: https://wertyai.online/v1
Chat: POST /v1/chat/completions
Models: GET /v1/models
Authorization: Bearer <WERTY_API_KEY>
Model: gpt-6-astra

Сейчас поддерживаются текстовые messages с ролями system, user, assistant, параметры max_tokens, temperature и stream. Изображения, tools, tool_calls, Responses API и Anthropic Messages API пока не поддерживаются. Поэтому наличие настройки провайдера в редакторе ещё не означает совместимость его агентного режима.

Названия моделей в Werty — алиасы маршрутов. Фактическая модель провайдера указана в поле backend_model ответа /v1/models.

CHATGPT / CUSTOM GPT ACTION

ChatGPT App

Подключите Werty как действие своего GPT. ChatGPT отправит выбранный запрос в Werty и покажет полученный ответ. Это внешний инструмент внутри чата; он не заменяет основную модель ChatGPT.

  1. На сайте ChatGPT откройте редактор своего GPT → Configure → Actions → Create new action. Нужен аккаунт с доступом к созданию GPT и Actions.
  2. Выберите Import from URL и вставьте адрес схемы ниже.
  3. В Authentication выберите API Key → Bearer и введите ключ Werty.
  4. В Instructions вставьте инструкцию ниже. Укажите Privacy policy URL: https://wertyai.online/privacy.
  5. В Preview попросите отправить «Привет» модели gpt-6-astra через askWerty и подтвердите вызов. Проверьте списание в кабинете Werty.
  6. Сохраните GPT с доступом «Только я». Откройте его в ChatGPT. Запросы действия оплачиваются с баланса владельца указанного ключа.
IMPORT FROM URL
https://wertyai.online/integrations/openapi.json
GPT INSTRUCTIONS
Когда пользователь просит ответ Werty, используй askWerty. Уточни модель, если она не указана; по умолчанию gpt-6-astra. Передавай только текст, который пользователь хочет отправить. Используй stream=false. Покажи ответ Werty без приписывания его основной модели ChatGPT. Если вызов не удался, сообщи об ошибке.

Доступность Actions зависит от аккаунта и политики организации; Pro mode не поддерживает Actions. Если редактор вашей версии уже переведён на Plugins, не ищите отсутствующее меню Actions: используйте доступный в аккаунте путь миграции и проверьте совместимость перед переносом.

Официальная инструкция Actions

CLAUDE DESKTOP / LOCAL MCP

Claude App

Для Claude Desktop подготовлен локальный MCP-коннектор с инструментом ask_werty. Он отправляет запросы в Werty через ваш API key. Основной Claude вызывает инструмент и получает ответ выбранной модели.

  1. Установите Node.js 20 или новее. В терминале проверьте node --version.
  2. Скачайте werty-mcp.mjs и сохраните, например, в C:\Werty\werty-mcp.mjs.
  3. В Claude Desktop откройте Settings → Developer → Edit Config. На Windows файл находится в %APPDATA%\Claude\claude_desktop_config.json.
  4. Добавьте блок ниже в mcpServers, сохранив существующие серверы. Замените путь и WERTY_API_KEY. Ключ хранится локально в этом файле: не публикуйте его.
  5. Полностью закройте и заново откройте Claude Desktop. Проверьте, что появился инструмент ask_werty.
  6. Напишите: «Через ask_werty спроси gpt-6-astra: Привет». Подтвердите вызов. Запрос расходует баланс Werty.
claude_desktop_config.json
{
  "mcpServers": {
    "werty": {
      "command": "node",
      "args": [
        "C:/Werty/werty-mcp.mjs"
      ],
      "env": {
        "WERTY_API_KEY": "ВСТАВЬТЕ_КЛЮЧ_WERTY"
      }
    }
  }
}

На macOS используйте абсолютный путь к скрипту и при необходимости к node. Этот локальный коннектор работает в Desktop. Для Claude в браузере или на телефоне требуется отдельно размещённый remote MCP-сервер; URL /v1 не является MCP-адресом.

Официальная настройка локального MCP в Claude Desktop

КОНФИГУРАЦИЯ ПРОВАЙДЕРА / ОГРАНИЧЕННАЯ СОВМЕСТИМОСТЬ

OpenCode

Для версий OpenCode с конфигурацией provider/npm создайте opencode.json в папке проекта. Ключ храните в переменной WERTY_API_KEY, а не в файле конфигурации.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "werty": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Werty",
      "options": {
        "baseURL": "https://wertyai.online/v1",
        "apiKey": "{env:WERTY_API_KEY}"
      },
      "models": {
        "gpt-6-astra": {
          "name": "ChatGPT 6 Astra"
        }
      }
    }
  },
  "model": "werty/gpt-6-astra"
}

Выберите werty/gpt-6-astra в списке моделей. Конфигурация задаёт подключение, но агент OpenCode отправляет tools и другие поля, которых пока нет в Werty API: такой запрос получит 400. Для проверки текстового запроса используйте curl. Для OpenCode v2 сверяйте формат конфигурации с документацией установленной версии.

Настройка пользовательского провайдера

ТЕКСТОВЫЕ ЗАПРОСЫ / ЗАВИСИТ ОТ ВЕРСИИ

Cursor

  1. Откройте Cursor Settings → Models → API Keys.
  2. Если в вашей версии доступна Override OpenAI Base URL, укажите https://wertyai.online/v1.
  3. В поле OpenAI API Key вставьте ключ Werty. Добавьте идентификатор gpt-6-astra и выберите его в чате.

Проверяйте обычный текстовый запрос. Agent, Tab и запросы с tools не поддерживаются текущим Werty API. Если проверка ключа запрашивает стандартную модель OpenAI, она может завершиться ошибкой: используйте именно ID из /v1/models. Поддержка произвольных endpoint зависит от версии Cursor.

Документация Cursor

ПОДДЕРЖИВАЕТСЯ

Терминал

Пример для Bash на macOS, Linux или WSL с установленным curl. Ключ вводится скрыто. Ответ возвращается в JSON; текст находится в choices[0].message.content.

BASH / CURL
read -rsp "Werty API key: " WERTY_API_KEY; echo
export WERTY_API_KEY
curl --fail-with-body https://wertyai.online/v1/chat/completions \
  -H "Authorization: Bearer $WERTY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6-astra","messages":[{"role":"user","content":"Привет!"}],"max_tokens":1024}'
ПОДДЕРЖИВАЕТСЯ

PowerShell

Пример для Windows PowerShell 5.1 и PowerShell 7. Вставьте команды, введите ключ и отправьте запрос. UTF-8 сохраняет русский текст.

POWERSHELL
$secret = Read-Host "Werty API key" -AsSecureString
$credential = [PSCredential]::new("werty", $secret)
$headers = @{ Authorization = "Bearer " + $credential.GetNetworkCredential().Password }
$payload = @{
  model = "gpt-6-astra"
  messages = @(@{ role = "user"; content = "Привет!" })
  max_tokens = 1024
} | ConvertTo-Json -Depth 5
$result = Invoke-RestMethod -Method Post `
  -Uri "https://wertyai.online/v1/chat/completions" `
  -Headers $headers -ContentType "application/json; charset=utf-8" `
  -Body ([Text.Encoding]::UTF8.GetBytes($payload))
$result.choices[0].message.content
ТРЕБУЕТСЯ АДАПТЕР ПРОТОКОЛА

Claude Code

Claude Code требует совместимый шлюз с поддержкой формата Anthropic, инструментов и потоковых событий. Текущий /v1/chat/completions Werty не является таким шлюзом. Простая подстановка Werty в ANTHROPIC_BASE_URL не заработает.

Для подключения сначала нужен адаптер Anthropic Messages → Werty и поддержка tools на сервере. После этого адрес адаптера указывается в ANTHROPIC_BASE_URL, а его ключ — в ANTHROPIC_AUTH_TOKEN. Готового адаптера в этом проекте пока нет.

Требования Claude Code к шлюзам

CUSTOM ENDPOINT / ТЕКСТОВЫЙ ЧАТ

VS Code

  1. В панели Chat откройте выбор модели → Manage Language Models.
  2. Нажмите Add Models → Custom Endpoint, задайте имя Werty и API key.
  3. Выберите API type: Chat Completions. В открывшемся chatLanguageModels.json задайте ID gpt-6-astra и URL https://wertyai.online/v1/chat/completions.
  4. Отключите tool calling и vision для этой модели. Выберите её для обычного текстового чата.

Настройка доступна в версиях VS Code с Custom Endpoint; корпоративная политика может ограничивать свои ключи. Agent и запросы с дополнительными неподдерживаемыми полями могут возвращать 400.

Настройка Custom Endpoint в VS Code

Если запрос не проходит

401 — проверьте ключ. 402 — пополните баланс. 400 — проверьте поля запроса и ID модели. 429 — повторите позже. 503 — маршрут модели временно недоступен. Сначала выполните пример из терминала: он проверяет базовое подключение независимо от редактора.