# Быстрый старт

Источник: https://docs.aicentos.com/ru/quickstart

Language: ru

> Подключение за три шага: регистрация аккаунта → создание API-ключа → ввод Base URL и ключа в клиенте

Подключение за три шага: **регистрация аккаунта → создание API-ключа → ввод Base URL и ключа в клиенте**.

## Шаг 1: регистрация аккаунта

Откройте [aicentos.com](https://aicentos.com/) и нажмите «**Начать работу**» в правом верхнем углу, чтобы перейти на страницу регистрации:

Страница регистрации

Укажите **имя пользователя** и **пароль**, примите пользовательское соглашение и нажмите «Создать аккаунт». При регистрации сразу начисляется **¥1** на тест — можно вызывать API без предварительного пополнения.

## Шаг 2: создание API-ключа

Войдите и откройте консоль, в меню слева выберите «**API-ключи**», затем нажмите «**Создать API-ключ**» в правом верхнем углу:

Страница API-ключей

Заполните параметры в открывшемся окне и нажмите «Сохранить изменения»:

Создание API-ключа

| Поле              | Описание                                                                                                                                         |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Название          | Задаётся вручную, чтобы различать проекты. Рекомендуем создавать отдельные ключи под разные задачи — так проще сводить затраты и отзывать доступ |
| Группа            | Выберите, через какую апстрим-группу идти; можно оставить пустым — будет использована группа по умолчанию                                        |
| Срок действия     | «Бессрочно» либо 1 час / 1 день / 1 месяц                                                                                                        |
| Количество        | За один раз можно создать несколько ключей; к названию автоматически добавится случайный суффикс                                                 |
| Безлимитная квота | Если выключить, можно задать лимит средств для ключа                                                                                             |

После создания ключ появится в списке — вида `sk-xxxxxxxxxxxx`, по умолчанию показывается замаскированным:

Ключ создан

В списке ключей есть поиск по названию и самому ключу; видны группа, квота, доступные модели, IP-ограничения и т. д. Ключ можно в любой момент отредактировать или удалить:

Список ключей

> **Ключ полностью показывается только один раз — при создании.** Сразу скопируйте и сохраните его в надёжном месте. Не встраивайте ключ во фронтенд-код и не коммитьте в публичные репозитории.

## Шаг 3: укажите Base URL и ключ в клиенте

### Сначала выберите правильный Base URL

Здесь ошибаются чаще всего: **для разных протоколов адреса разные**.

| Сценарий                                        | Base URL                  |
| ----------------------------------------------- | ------------------------- |
| Codex / формат, совместимый с OpenAI            | `https://aicentos.com/v1` |
| Claude Code / формат Anthropic и другие клиенты | `https://aicentos.com`    |

> **Для протокола Anthropic указывайте только корневой адрес** — не добавляйте `/v1/messages` вручную, клиент соберёт путь сам.

Посмотреть и скопировать адрес можно также в выпадающем списке «**API-адрес**» в правом верхнем углу страницы «API-ключи» в консоли:

API-адрес

### Проверка соединения

Выполните минимальный запрос через curl, чтобы убедиться, что ключ и сеть работают:

```bash
export AICENTOS_API_KEY="sk-ваш-ключ"

curl https://aicentos.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AICENTOS_API_KEY" \
  -d '{
    "model": "gemini-3.8-flash",
    "messages": [
      {"role": "user", "content": "Расскажи о себе одним предложением"}
    ]
  }'
```

Можно сначала запросить список моделей: если возвращается JSON, ключ и Base URL работают.

```bash
export AICENTOS_API_KEY="sk-ваш-ключ"

curl https://aicentos.com/v1/models \
  -H "Authorization: Bearer $AICENTOS_API_KEY"
```

### Python (OpenAI SDK)

```python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AICENTOS_API_KEY"],
    base_url="https://aicentos.com/v1",
)

resp = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[{"role": "user", "content": "Расскажи о себе одним предложением"}],
)
print(resp.choices[0].message.content)
```

### Node.js (OpenAI SDK)

В примере используется ESM: файл должен называться `.mjs`, либо добавьте `"type": "module"` в `package.json`:

```js
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.AICENTOS_API_KEY,
  baseURL: 'https://aicentos.com/v1',
});

const resp = await client.chat.completions.create({
  model: 'gemini-3.8-flash',
  messages: [{ role: 'user', content: 'Расскажи о себе одним предложением' }],
});

console.log(resp.choices[0].message.content);
```

### Популярные клиенты

* [Подключение Claude Code](https://docs.aicentos.com/ru/claude-code) — импорт в один клик через CC Switch или ручная настройка
* [Подключение Codex](https://docs.aicentos.com/ru/codex) — настройка через графический интерфейс или config.toml вручную
* [Подключение Cursor](https://docs.aicentos.com/ru/cursor) — пользовательские настройки, совместимые с OpenAI
* [Подключение Cherry Studio](https://docs.aicentos.com/ru/cherry-studio) — добавление провайдера, совместимого с OpenAI

## Пополнение

Когда бонус за регистрацию закончится, пополните баланс в разделе «**Кошелёк**» в левой части консоли:

Кошелёк

Суммы пополнения и скидки (**от ¥100 действует скидка — к оплате меньше суммы пополнения**):

| Сумма пополнения     | Скидка | К оплате    |
| -------------------- | ------ | ----------- |
| ¥1 / ¥10 / ¥20 / ¥50 | нет    | полная цена |
| ¥100                 | 1% OFF | ¥99         |
| ¥500                 | 2% OFF | ¥490        |
| ¥1,000               | 3% OFF | ¥970        |
| ¥10,000              | 5% OFF | ¥9,500      |

Можно указать и произвольную сумму либо пополнить баланс по коду пополнения.

Способы оплаты

* **Способы оплаты**: Alipay, WeChat Pay, банковский перевод
* **Средства не сгорают**, списания идут по фактическому расходу токенов
* Есть реферальная программа: после регистрации по ссылке-приглашению обе стороны получают бонус, его можно в любой момент перевести в баланс

## Просмотр расходов

Детализацию расходов смотрите в «**Дашборде**» в левой части консоли:

Обзор консоли

Там видны текущий баланс, суммарное потребление, число API-запросов и тренды вызовов по моделям:

Дашборд

## Попробуйте без кода

В разделе «**Чат**» в верхней части консоли есть встроенный плейграунд: можно сразу выбрать модель, отправить сообщения и подбирать промпт по ходу общения:

Плейграунд

## Что дальше

* Протестируйте модели прямо в браузере в [плейграунде](https://aicentos.com/playground) — без кода
* Откройте [поддерживаемые модели](https://docs.aicentos.com/ru/billing/models-list) — какие LLM доступны
* Изучите [обработку ошибок](https://docs.aicentos.com/ru/billing/errors) — разбор 401, нехватки баланса и других проблем
* Ознакомьтесь с [правилами тарификации](https://docs.aicentos.com/ru/billing/pricing) — оплата по использованию и предупреждения о балансе