From bc673e7c24382a3b8d01e78ac5f3c17cc76ebccb Mon Sep 17 00:00:00 2001
From: Sergey <93754860+slaid098@users.noreply.github.com>
Date: Thu, 6 Aug 2026 11:10:06 +0300
Subject: [PATCH] docs(readme): fix custom STT endpoint section (#49)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

## Что сделано

- EN и RU секции «Custom STT Endpoint» обновлены: nginx-конфиг заменён
на pass-through вариант без префикса:
  ```nginx
  location / {
      proxy_pass https://api.groq.com:443;
      proxy_set_header Host api.groq.com;
  }
  ```
- Пример endpoint теперь
`https://your-domain.com/openai/v1/audio/transcriptions` (без `/groq`) —
совпадает с реальной настройкой сервера (whisper.slaid098.dev).
- Добавлена заметка в обе секции: префикс пути не нужен, если домен
выделен только под Groq; `/groq`-вариант остаётся валидным для
мульти-прокси доменов (`location /groq/` с trailing slash срезает
префикс).

## Почему

README описывал конфиг с префиксом `/groq`, который не совпадает с
реальной настройкой. `proxy_pass` без trailing slash передаёт URI как
есть, поэтому на выделенном домене префикс лишний и только усложняет
настройку. Документация должна совпадать с реальным рабочим сервером.

## Watch out

- Только README.md (EN + RU секции). Код, тесты, версия не тронуты —
bump не требуется по AGENTS.md.

## Pending

—

Closes #48

Closes #48

---------

Co-authored-by: opencode-agent <agent@opencode.local>
---
 README.md | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 4e1fa00..72c759f 100644
--- a/README.md
+++ b/README.md
@@ -49,14 +49,16 @@ Groq may block direct requests from some networks. Point the script at your own
 
 1. Deploy an nginx reverse proxy that forwards to `api.groq.com`:
    ```nginx
-   location /groq/ {
-       proxy_pass https://api.groq.com/;
+   location / {
+       proxy_pass https://api.groq.com:443;
        proxy_set_header Host api.groq.com;
    }
    ```
-2. Tampermonkey menu → **Set STT Endpoint** → paste `https://your-domain.com/groq/openai/v1/audio/transcriptions`
+2. Tampermonkey menu → **Set STT Endpoint** → paste `https://your-domain.com/openai/v1/audio/transcriptions`
 3. Requests now go through your proxy. The userscript metadata uses `@connect *`, so any domain is allowed.
 
+A path prefix is not needed if the domain is dedicated to Groq. The `/groq` variant stays valid for multi-proxy domains — `location /groq/` with a trailing slash strips the prefix.
+
 ### 🌡️ Temperature
 
 Whisper may hallucinate on silence/noise. **Set Temperature** (default `0` = deterministic, range `0`–`1`) reduces hallucinations.
@@ -111,14 +113,16 @@ Groq может блокировать прямые запросы из неко
 
 1. Разверни nginx reverse proxy, который форвардит на `api.groq.com`:
    ```nginx
-   location /groq/ {
-       proxy_pass https://api.groq.com/;
+   location / {
+       proxy_pass https://api.groq.com:443;
        proxy_set_header Host api.groq.com;
    }
    ```
-2. Меню Tampermonkey → **Set STT Endpoint** → вставь `https://your-domain.com/groq/openai/v1/audio/transcriptions`
+2. Меню Tampermonkey → **Set STT Endpoint** → вставь `https://your-domain.com/openai/v1/audio/transcriptions`
 3. Запросы пойдут через твой прокси. Метаблок юзерскрипта использует `@connect *`, поэтому разрешён любой домен.
 
+Префикс пути не нужен, если домен выделен только под Groq. `/groq`-вариант остаётся валидным для мульти-прокси доменов — `location /groq/` с trailing slash срезает префикс.
+
 ### 🌡️ Temperature
 
 Whisper может галлюцинировать на тишине/шуме. **Set Temperature** (по умолчанию `0` = детерминированный вывод, диапазон `0`–`1`) снижает галлюцинации.