> For the complete documentation index, see [llms.txt](https://stelaris.gitbook.io/stelaris-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stelaris.gitbook.io/stelaris-docs/chatbox.md).

# Настройка Chatbox (Android, iOS)

Пошаговое руководство по подключению STELARIS API в приложении Chatbox и актуальный каталог моделей

> **Сервис:** STELARIS (`https://stelaris.xyz`)\
> **API эндпоинт:** `https://stelaris.xyz/v1`\
> **Формат:** OpenAI-совместимый API\
> **Статус в РФ:** Работает без VPN и ограничений

[Chatbox AI](https://chatboxai.app/) — кроссплатформенный клиент для работы с искусственным интеллектом на **iOS (iPhone/iPad)**, **Android**, а также на компьютерах (**Windows, macOS, Linux**).

Позволяет использовать единый баланс и ключ STELARIS для доступа ко всем моделям в одном окне.

***

## 📥 Шаг 1. Установка приложения

* **iOS (iPhone / iPad):** [Chatbox AI в App Store](https://apps.apple.com/app/chatbox-ai/id6471368056)
* **Android:** [Chatbox AI в Google Play](https://play.google.com/store/apps/details?id=xyz.chatboxapp.chatbox) или APK на [chatboxai.app](https://chatboxai.app/)
* **Десктоп (ПК/Mac):** Официальная версия на [chatboxai.app](https://chatboxai.app/)

***

## ⚙️ Шаг 2. Подключение API STELARIS

1. Откройте **Chatbox** на смартфоне.
2. Перейдите в **«Настройки»** (шестерёнка ⚙️) ➔ вкладка **«Модель»** (*Model / AI Provider*).
3. Заполните параметры подключения:
   * **Поставщик модели (AI Model Provider):** выберите **OpenAI API**
   * **API Host (URL-адрес API):**

     ```
     https://stelaris.xyz/v1
     ```

     *(⚠️ Важно: обязательно с протоколом `https://` и суффиксом `/v1`)*
   * **Ключ API (API Key):**

     ```
     sk-stel-XXXX...
     ```

     *(Вставьте ваш личный токен STELARIS — он выдаётся после покупки)*
4. Нажмите **«Проверить»** (*Check*) ➔ загорится зелёный индикатор ➔ нажмите **«Сохранить»** (*Save*).

***

## 🏆 Шаг 3. Каталог популярных моделей

В поле **«Модель» (Model)** укажите идентификатор из таблицы (ID копируется точно, с точками и дефисами):

| Модель                       | Идентификатор (ID)         | Провайдер | Сила  | Коэф. | Для чего                                                                  |
| ---------------------------- | -------------------------- | --------- | ----- | ----- | ------------------------------------------------------------------------- |
| **GPT-6 Astra**              | `gpt-6-astra`              | OpenAI    | ★★★★★ | x10   | Абсолютный флагман: сложная логика, код, агентные пайплайны. Контекст 1M. |
| **GPT-5.6 Luna**             | `gpt-5.6-luna`             | OpenAI    | ★★★   | x0,5  | Эконом для массовых задач: чаты, суммаризация. Контекст 1M.               |
| **Claude Fable 5.1**         | `claude-fable-5-1`         | Anthropic | ★★★★★ | x8    | Высшая точность, анализ документов, код. Контекст 1M.                     |
| **Claude Opus 5.5**          | `claude-opus-5-5`          | Anthropic | ★★★★★ | x4    | Архитектура приложений, рефакторинг крупных проектов. Контекст 1M.        |
| **Claude Opus 4.6 Thinking** | `claude-opus-4-6-thinking` | Anthropic | ★★★★☆ | x4    | Режим рассуждений: сначала думает, потом отвечает.                        |
| **Claude Sonnet 5**          | `claude-sonnet-5`          | Anthropic | ★★★★  | x2    | Быстрый повседневный код и тексты. Контекст 1M.                           |
| **Gemini 3.8 Flash**         | `gemini-3.8-flash`         | Google    | ★★★★  | x2    | Мультимодальный: текст, фото, аудио, видео, PDF. Контекст 1M.             |
| **Gemini 3.1 Pro**           | `gemini-3.1-pro`           | Google    | ★★★★★ | x2    | Документы и смешанные данные. Контекст 1M.                                |
| **Grok 4.7**                 | `grok-4.7`                 | xAI       | ★★★★  | x0,5  | Свежие знания, дерзкий стиль. Выгодный коэффициент.                       |
| **GLM 5.3**                  | `glm-5.3`                  | Zhipu     | ★★★★  | x1,5  | Сильный универсал без ценника флагмана.                                   |
| **Kimi K3**                  | `kimi-k3`                  | Moonshot  | ★★★★  | x2,5  | Длинные документы и код.                                                  |
| **DeepSeek V4.1 Flash**      | `deepseek-v4.1-flash`      | DeepSeek  | ★★★   | x0,1  | Ультра-выгода для кода и продакшена.                                      |
| **Nano Banana (картинки)**   | `gemini-3.1-flash-image`   | Google    | ★★★★  | х2.5  | Генерация и редактирование изображений.                                   |
| **GPT Image 2**              | `gpt-image-2`              | OpenAI    | ★★★★  | —     | Генерация изображений (фикс. цена за картинку).                           |

> 💡 Это топ-15 из \~40 моделей. **Полный актуальный каталог** с коэффициентами: `GET https://stelaris.xyz/v1/models` с вашим ключом.

> 💡 **Переключение в один тап:** в Chatbox можно менять модель прямо в шапке любого открытого диалога без перехода в настройки.

> 🧾 **Как читать списание:** токены × коэффициент модели. Пример: 100 000 токенов через Grok 4.7 (x0,5) спишут 50 000 с баланса, через Fable 5.1 (x8) — 800 000.

***

## ❓ Вопросы и устранение проблем

### Нужен ли VPN?

**Нет.** Весь трафик идет через европейский шлюз STELARIS напрямую. Работает на всех мобильных сетях РФ без ограничений.

### Ошибка 401 Unauthorized:

Проверьте API-ключ — убедитесь, что при копировании не захватили пробелы в начале или конце. Ключ начинается с `sk-stel-`.

### Ошибка «model not found»:

Проверьте ID модели — точками и дефисами: `gemini-3.8-flash` (точка), `claude-sonnet-5` (без версии-суффикса). Полный список: `/v1/models`.

### Ошибка Connection Error:

Проверьте поле **API Host**: должно быть строго `https://stelaris.xyz/v1`.

### Баланс кончился быстрее, чем ожидалось?

Коэффициент: дорогие флагманы (x4–x8) списывают больше токенов за запрос. Для фоновых задач берите эконом-модели: `gpt-5.6-luna`, `grok-4.7`, `deepseek-v4.1-flash`.