====== Руководство по настройке AI Mod ======

На этой странице объясняется, как настроить различные AI-провайдеры для использования с AI Mod. Выберите провайдера, который лучше всего подходит вам. Некоторые бесплатны, другие требуют оплаты или локального хостинга.

Чтобы выбрать провайдера, откройте Настройки - AI.

===== OpenRouter (Рекомендуется) =====
OpenRouter позволяет получить доступ к множеству моделей через единый API.

**Шаги настройки:**
  - Создайте API-ключ здесь: https://openrouter.ai/settings/keys  
  - Скопируйте ключ и вставьте его в поле **"API key"** в настройках провайдера.
  - Просмотрите доступные модели здесь: https://openrouter.ai/models  
  - Скопируйте **ID модели** (нажмите на кнопку рядом с названием модели) и вставьте его в поле **"Model"** в настройках провайдера.

**Примечания:**
  * Некоторые модели бесплатны, другие платные (оплата за каждый запрос).
  * Доступны популярные модели, включая GPT-4, Claude, Mistral, MythoMax и другие.

===== OpenAI =====
Этот провайдер поддерживает все модели, предоставляемые через официальный API OpenAI, включая GPT-4 и GPT-5.

**Шаги настройки:**
  - Создайте API-ключ здесь: https://platform.openai.com/api-keys  
  - Вставьте ключ в поле **"API key"** в настройках провайдера.
  - Укажите название модели (например, `gpt-3.5-turbo` или `gpt-4`) в поле **"Model"**.

**Примечания:**
  * Оплата производится по количеству токенов (вход + выход).
  * Официальный и стабильный доступ к моделям OpenAI.
  * NSFW-контент запрещён — такие запросы могут быть заблокированы или отфильтрованы.

===== Ollama (Локальный хостинг) =====
Ollama позволяет запускать модели локально на вашем компьютере.

**Шаги настройки:**
  - Скачайте и установите Ollama: https://ollama.com/
  - Запустите Ollama и загрузите модель, например: `ollama run llama3`
  - В настройках провайдера укажите:
    - **API URL:** `http://localhost:11434`  
    - **Model:** `llama3` (или любую другую загруженную модель)

**Примечания:**
  * Работает локально, данные не отправляются третьим лицам.
  * Для большинства моделей требуется мощная видеокарта.
  * Подходит для полной конфиденциальности и офлайн-использования.

===== Cloudflare AI Gateway =====
Прокси-уровень, позволяющий перенаправлять запросы к другим AI-провайдерам через инфраструктуру Cloudflare.

**Шаги настройки:**
  - Ознакомьтесь с документацией: https://developers.cloudflare.com/ai-gateway/
  - Зарегистрируйтесь и настройте свой шлюз.
  - Используйте предоставленный endpoint и ключ в настройках провайдера.

**Примечания:**
  * Доступен бесплатный тариф с ограничениями.

===== Совместимость с OpenAI-совместимыми API =====
Многие другие провайдеры (например, Together.ai, DeepInfra, Groq) поддерживают API, совместимые с OpenAI. Если провайдер предоставляет:
  - базовый URL,
  - API-ключ,
  - название модели,

...вы можете использовать их в AI Mod через провайдера типа "OpenAI".

**Важно:**
  - Некоторые модели могут блокировать или фильтровать взрослый контент.
  - Для NSFW-контента рекомендуется использовать локальные модели или OpenRouter с моделями, которые явно разрешают такой контент.