Документация API
HubFreqDash — OpenAI-совместимый прокси. Один адрес и один ключ дают доступ ко всем моделям каталога; менять формат запросов не нужно.
base_url
https://hub.freqdash.com/v1
Аутентификация
Authorization: Bearer sk-hub_...
Моделей в каталоге
16
Бесплатных моделей
2
Базовый адрес и аутентификация
Прокси принимает те же запросы, что и api.openai.com, но по адресу шлюза HubFreqDash.
- Базовый адрес API: https://hub.freqdash.com/v1 — от него строятся пути /models и /chat/completions.
- Ключ передаётся заголовком Authorization: Bearer sk-hub_.... Ключи создаются, ограничиваются и отзываются в кабинете.
- Один ключ работает и с CLI-агентами, и с IDE, и с серверным кодом — лимит считается на аккаунт тарифа, а не на конкретного клиента.
Authorization: Bearer sk-hub_...Эндпоинты
Поддерживаются эндпоинты OpenAI-формата, которые используются клиентами и агентами.
| Метод | Путь | Назначение |
|---|---|---|
| GET | /models | Список моделей, доступных ключу: id, контекст и цены за токены. |
| POST | /chat/completions | Чат-комплишены OpenAI-формата, включая стриминг и вызов инструментов. |
Список моделей
Возвращает модели, доступные текущему ключу, с контекстом и ценами за токены, если провайдер их отдаёт.
curl https://hub.freqdash.com/v1/models \
-H "Authorization: Bearer $OPENAI_API_KEY"Поле model в запросах чата совпадает с id из ответа — прокси не переименовывает модели.
Чат-комплишены
Стандартный OpenAI-запрос: сообщения, temperature, tools и прочие привычные поля.
curl https://hub.freqdash.com/v1/chat/completions \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4-flash",
"messages": [
{"role": "system", "content": "Отвечай кратко"},
{"role": "user", "content": "Что такое LLM-прокси?"}
],
"temperature": 0.7
}'{
"id": "chatcmpl-...",
"object": "chat.completion",
"model": "deepseek-v4-flash",
"choices": [
{
"index": 0,
"message": {"role": "assistant", "content": "..."},
"finish_reason": "stop"
}
],
"usage": {"prompt_tokens": 24, "completion_tokens": 118, "total_tokens": 142}
}Стриминг
С флагом stream=true ответ приходит в формате SSE: строки data: с дельтами и завершающий data: [DONE].
curl -N https://hub.freqdash.com/v1/chat/completions \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4-flash",
"messages": [{"role": "user", "content": "Считай до пяти"}],
"stream": true
}'data: {"choices":[{"delta":{"role":"assistant","content":"Один"},"index":0}]}
data: {"choices":[{"delta":{"content":" два"},"index":0}]}
data: [DONE]from openai import OpenAI
client = OpenAI(base_url="https://hub.freqdash.com/v1", api_key="sk-hub_...")
stream = client.chat.completions.create(
model="deepseek-v4-flash",
messages=[{"role": "user", "content": "Считай до пяти"}],
stream=True,
)
for chunk in stream:
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="", flush=True)Каталог моделей
Идентификаторы, вендор и регион размещения. Числовые характеристики (контекст, цена за 1M токенов) приходят из GET /v1/models и здесь не дублируются.
| ID модели | Название | Вендор | Регион | Тариф |
|---|---|---|---|---|
| deepseek-v4-flash | DeepSeek V4 Flash | DeepSeek | вне РФ | Free |
| qwen3.6-plus | Qwen 3.6 Plus | Alibaba | вне РФ | Free |
| deepseek-v4.1-flash | DeepSeek V4.1 Flash | DeepSeek | вне РФ | Платный |
| deepseek-v4-pro | DeepSeek V4 Pro | DeepSeek | вне РФ | Платный |
| qwen3.7-max | Qwen 3.7 Max | Alibaba | вне РФ | Платный |
| qwen3.8-max | Qwen 3.8 Max | Alibaba | вне РФ | Платный |
| glm-5.1 | GLM 5.1 | Zhipu | вне РФ | Платный |
| glm-5.3 | GLM 5.3 | Zhipu | вне РФ | Платный |
| kimi-k2.6 | Kimi K2.6 | Moonshot | вне РФ | Платный |
| kimi-k2.7-code | Kimi K2.7 Code | Moonshot | вне РФ | Платный |
| kimi-k3 | Kimi K3 | Moonshot | вне РФ | Платный |
| minimax-m2.7 | MiniMax M2.7 | MiniMax | вне РФ | Платный |
| minimax-m3 | MiniMax M3 | MiniMax | вне РФ | Платный |
| mimo-v2.5-pro | MiMo V2.5 Pro | Xiaomi | вне РФ | Платный |
| gpt-5.6-luna | GPT-5.6 Luna | OpenAI | вне РФ | Платный |
| longcat-2.0 | LongCat 2.0 | Meituan | вне РФ | Платный |
Лимиты тарифов
Лимит запросов считает сам шлюз по окну тарифа. При превышении возвращается 429 с заголовком Retry-After.
| Тариф | Цена | Лимит запросов | Модели |
|---|---|---|---|
| Free | 0 ₽ / мес | 150 запросов / 3 ч | Бесплатные модели |
| Starter | 2 500 ₽ / мес | 3 000 запросов / 3 ч | Все модели каталога |
| Pro | 4 900 ₽ / мес | 10 000 запросов / 3 ч | Все модели каталога |
Подробное сравнение опций — на странице тарифов.
Ошибки
Формат ошибок совместим с OpenAI: объект error внутри JSON-ответа.
{
"error": {
"message": "Rate limit exceeded for plan starter",
"type": "rate_limit_exceeded",
"code": "rate_limit_exceeded"
}
}| HTTP | code | Когда возникает | Что делать |
|---|---|---|---|
| 401 | invalid_api_key | Заголовок Authorization отсутствует, ключ неизвестен или отозван. | Проверьте, что ключ передан как Bearer и создан в кабинете. |
| 403 | model_not_allowed | Модель не входит в тариф (например, платная модель на Free). | Выберите модель из разрешённого списка или перейдите на Starter/Pro. |
| 429 | rate_limit_exceeded | Исчерпан лимит запросов за окно тарифа. | Повторите запрос после времени из заголовка Retry-After или поднимите тариф. |
| 502 | gateway_unavailable | Шлюз не смог получить ответ от провайдера модели. | Повторите запрос; если повторяется — напишите в поддержку. |
Переменные окружения клиентов
Большинство клиентов читают адрес и ключ из окружения — код приложения менять не нужно.
| Переменная | Значение |
|---|---|
| OPENAI_BASE_URL | https://hub.freqdash.com/v1 |
| OPENAI_API_KEY | sk-hub_... |
OPENAI_BASE_URL="https://hub.freqdash.com/v1"
OPENAI_API_KEY="sk-hub_..."export OPENAI_BASE_URL="https://hub.freqdash.com/v1"
export OPENAI_API_KEY="sk-hub_..."Часть клиентов (например, старые версии LangChain) используют алиас OPENAI_API_BASE — подставьте тот же адрес.