docs(readme): fix custom STT endpoint section (#49)
Some checks failed
CI / check (push) Successful in 1m41s
Deploy / build (push) Failing after 5s

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

- 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>
This commit is contained in:
Sergey 2026-08-06 11:10:06 +03:00 committed by GitHub
parent b8040f6cd3
commit bc673e7c24
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -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`: 1. Deploy an nginx reverse proxy that forwards to `api.groq.com`:
```nginx ```nginx
location /groq/ { location / {
proxy_pass https://api.groq.com/; proxy_pass https://api.groq.com:443;
proxy_set_header Host api.groq.com; 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. 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 ### 🌡️ Temperature
Whisper may hallucinate on silence/noise. **Set Temperature** (default `0` = deterministic, range `0``1`) reduces hallucinations. 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`: 1. Разверни nginx reverse proxy, который форвардит на `api.groq.com`:
```nginx ```nginx
location /groq/ { location / {
proxy_pass https://api.groq.com/; proxy_pass https://api.groq.com:443;
proxy_set_header Host api.groq.com; 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 *`, поэтому разрешён любой домен. 3. Запросы пойдут через твой прокси. Метаблок юзерскрипта использует `@connect *`, поэтому разрешён любой домен.
Префикс пути не нужен, если домен выделен только под Groq. `/groq`-вариант остаётся валидным для мульти-прокси доменов — `location /groq/` с trailing slash срезает префикс.
### 🌡️ Temperature ### 🌡️ Temperature
Whisper может галлюцинировать на тишине/шуме. **Set Temperature** (по умолчанию `0` = детерминированный вывод, диапазон `0``1`) снижает галлюцинации. Whisper может галлюцинировать на тишине/шуме. **Set Temperature** (по умолчанию `0` = детерминированный вывод, диапазон `0``1`) снижает галлюцинации.