# SoftHive.ru — Полный технический справочник для AI-ботов и агентов (llms-full.txt)

> Данный документ содержит детальную техническую информацию обо всех поддерживаемых типах бесплатных LLM API, провайдерах, параметрах конфигурации и лимитах на платформе SoftHive.ru.

## 1. Спецификация подключения (OpenAI Compatibility Standard)

Большинство провайдеров на SoftHive.ru совместимы со спецификацией OpenAI Chat Completions API:
- Endpoint: `{base_url}/chat/completions`
- Метод: `POST`
- Заголовки:
  - `Authorization: Bearer {API_KEY}`
  - `Content-Type: application/json`

### Пример тела запроса:
```json
{
  "model": "{model_id}",
  "messages": [
    {"role": "system", "content": "You are a helpful coding assistant."},
    {"role": "user", "content": "Напиши функцию на TypeScript."}
  ],
  "temperature": 0.7,
  "max_tokens": 4096
}
```

## 2. Справочник провайдеров и настроек подключения

### 1. OpenRouter
- **Сайт**: https://openrouter.ai
- **Base URL**: `https://openrouter.ai/api/v1`
- **Бесплатные модели**: Модели с суффиксом `:free` (например, `deepseek/deepseek-r1:free`, `meta-llama/llama-3.3-70b-instruct:free`, `google/gemini-2.0-flash-exp:free`)
- **Требования**: Регистрация через Google или GitHub, привязка карты НЕ требуется.
- **Работа в РФ**: Требуется VPN для сайта, API доступен.

### 2. Groq
- **Сайт**: https://console.groq.com
- **Base URL**: `https://api.groq.com/openai/v1`
- **Модели**: `llama-3.3-70b-versatile`, `llama-3.1-8b-instant`, `deepseek-r1-distill-llama-70b`, `mixtral-8x7b-32768`
- **Лимиты**: до 30 RPM, 14 400 RPD, 6 000 TPM
- **Особенности**: Экстремальная скорость ответа на чипах LPU (300-500 токенов/сек).

### 3. NVIDIA NIM
- **Сайт**: https://build.nvidia.com
- **Base URL**: `https://integrate.api.nvidia.com/v1`
- **Модели**: 70+ моделей, включая LLaMA 3.1 405B, Nemotron-70B, DeepSeek R1, Mistral Large
- **Квота**: 1000 бесплатных кредитов на аккаунт разработчика.

### 4. Cerebras
- **Сайт**: https://cloud.cerebras.ai
- **Base URL**: `https://api.cerebras.ai/v1`
- **Модели**: `llama3.1-8b`, `llama3.1-70b`
- **Скорость**: До 1800 токенов/сек для 8B моделей.

### 5. Hugging Face
- **Сайт**: https://huggingface.co
- **Base URL**: `https://api-inference.huggingface.co/v1`
- **Модели**: Тысячи open-source моделей с бесплатным community token.

### 6. Mistral AI (La Plateforme)
- **Сайт**: https://console.mistral.ai
- **Base URL**: `https://api.mistral.ai/v1`
- **Модели**: `codestral-latest`, `mistral-small-latest`, `open-mistral-nemo`
- **Бесплатный уровень**: Experimentation tier с ограничением по RPM.

## 3. Шаблоны интеграции в среды разработки

### Cursor IDE (.cursorrules / Настройки модели)
В Cursor -> Settings -> Models -> OpenAI API Key:
- Вставьте бесплатный ключ от Groq или OpenRouter.
- Override OpenAI Base URL: укажите `https://openrouter.ai/api/v1` или `https://api.groq.com/openai/v1`.
- Добавьте имя модели (например, `deepseek/deepseek-r1:free`).

### Windsurf Cascade
В Windsurf -> Preferences -> Cascade -> Provider Settings:
- Выберите OpenAI Compatible Provider.
- Base URL и API Key соответствующего провайдера.

### Claude Code CLI
```bash
export OPENAI_BASE_URL="https://openrouter.ai/api/v1"
export OPENAI_API_KEY="ваш_бесплатный_ключ"
```

### Python SDK (openai)
```python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.groq.com/openai/v1",
    api_key="gsk_..."
)

response = client.chat.completions.create(
    model="llama-3.3-70b-versatile",
    messages=[{"role": "user", "content": "Привет! Расскажи о себе."}]
)
print(response.choices[0].message.content)
```

## 4. Контактная информация и метаданные

- Сайт: https://softhive.ru
- Поддержка: support@softhive.ru
- Каталог нейросетей: https://softhive.ru/catalog
- Интерактивный генератор конфигов: https://softhive.ru/config