> For the complete documentation index, see [llms.txt](https://docs.onerpa.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onerpa.ru/ai-platforma-oneapa/provajdery-llm/openai.md).

# OpenAI

Настройка OpenAI в качестве LLM провайдера для OneAPA.

## Обзор

**OpenAI** — ведущий провайдер языковых моделей, создатель GPT-4.

### Преимущества

| Преимущество | Описание                        |
| ------------ | ------------------------------- |
| Качество     | Лучшие модели на рынке          |
| Vision       | Поддержка изображений           |
| Reasoning    | Модели o1, o3 для сложных задач |
| web\_search  | Встроенный поиск в интернете    |

### Ограничения

| Ограничение        | Описание                       |
| ------------------ | ------------------------------ |
| Цена               | Дороже большинства альтернатив |
| Конфиденциальность | Данные обрабатываются в облаке |

## Получение доступа

### Шаг 1: Создание аккаунта

1. Зарегистрируйтесь на [platform.openai.com](https://platform.openai.com/)
2. Подтвердите email
3. Добавьте способ оплаты

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

1. Перейдите в [API Keys](https://platform.openai.com/api-keys)
2. Нажмите "Create new secret key"
3. Дайте ключу понятное имя (например, "OneAPA Production")
4. Скопируйте ключ — он показывается **только один раз**

{% hint style="danger" %}
Храните API ключ в безопасном месте. Не публикуйте его в коде или репозиториях.
{% endhint %}

### Шаг 3: Пополнение баланса

1. Перейдите в Billing
2. Пополните баланс или настройте автоплатежи

## Настройка в OneAPA

### Создание модели

1. Откройте справочник "Модели"
2. Создайте новый элемент
3. Заполните поля:

| Поле         | Значение      |
| ------------ | ------------- |
| Наименование | OpenAI GPT-4o |
| Провайдер    | OpenAI        |
| Ключ         | sk-proj-...   |
| Каталог      | gpt-4o        |
| URL          | (пусто)       |

### Примеры настройки

**GPT-4o (рекомендуется):**

```
Наименование: OpenAI GPT-4o
Провайдер: OpenAI
Ключ: sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxx
Каталог: gpt-4o
```

**GPT-4o-mini (экономичная):**

```
Наименование: OpenAI GPT-4o-mini
Провайдер: OpenAI
Ключ: sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxx
Каталог: gpt-4o-mini
```

**o1 (reasoning):**

```
Наименование: OpenAI o1
Провайдер: OpenAI
Ключ: sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxx
Каталог: o1
```

## Доступные модели

### Основные модели

| Модель          | ID          | Описание                            |
| --------------- | ----------- | ----------------------------------- |
| **GPT-4o**      | gpt-4o      | Мультимодальная, оптимальный баланс |
| **GPT-4o-mini** | gpt-4o-mini | Быстрая и экономичная               |
| **GPT-4 Turbo** | gpt-4-turbo | Большой контекст (128K)             |
| **GPT-4**       | gpt-4       | Классическая версия                 |

### Reasoning модели

| Модель | ID | Описание                  |
| ------ | -- | ------------------------- |
| **o1** | o1 | Улучшенное рассуждение    |
| **o3** | o3 | Новейшая reasoning модель |

{% hint style="info" %}
Для reasoning моделей автоматически применяется `temperature=1`. Эти модели специально оптимизированы для сложных логических задач.
{% endhint %}

## Особенности

### Vision (изображения)

Модели GPT-4o, GPT-4-turbo поддерживают анализ изображений:

```
Пользователь: [прикрепляет скриншот Excel]
              "Какие данные на этом скриншоте?"

Агент: "На скриншоте показана таблица Excel с данными о продажах:
       - Столбец A: Наименование товара
       - Столбец B: Количество
       - Столбец C: Сумма
       Всего 15 строк данных, итоговая сумма 150 000 ₽"
```

### web\_search (поиск в интернете)

Модели OpenAI могут искать актуальную информацию:

```
Пользователь: "Какой курс доллара сегодня?"

Агент: 🔍 Использую web_search...
       "По данным ЦБ РФ на 23.01.2026, курс доллара составляет 92.50 ₽"
```

### Reasoning (рассуждение)

Модели o1, o3 показывают процесс рассуждения:

```
Пользователь: "Проанализируй, стоит ли открывать филиал в Казани"

Агент (o1): 
<thinking>
1. Анализирую текущие показатели компании...
2. Изучаю рынок Казани...
3. Оцениваю конкурентов...
4. Рассчитываю потенциальную окупаемость...
</thinking>

"На основе анализа, открытие филиала в Казани целесообразно по 
следующим причинам:..."
```

## Стоимость

| Модель      | Вход (1M токенов) | Выход (1M токенов) |
| ----------- | ----------------- | ------------------ |
| gpt-4o      | $2.50             | $10.00             |
| gpt-4o-mini | $0.15             | $0.60              |
| gpt-4-turbo | $10.00            | $30.00             |
| o1          | $15.00            | $60.00             |
| o3          | \~$20.00          | \~$80.00           |

{% hint style="info" %}
Актуальные цены на [openai.com/pricing](https://openai.com/pricing)
{% endhint %}

## Устранение проблем

### Ошибка авторизации (401)

| Причина            | Решение                        |
| ------------------ | ------------------------------ |
| Неверный API ключ  | Проверьте ключ, создайте новый |
| Ключ деактивирован | Создайте новый ключ            |
| Неверный формат    | Ключ должен начинаться с `sk-` |

### Недостаточно средств (402)

| Причина        | Решение                      |
| -------------- | ---------------------------- |
| Пустой баланс  | Пополните счёт               |
| Превышен лимит | Увеличьте лимит в настройках |

### Превышен rate limit (429)

| Причина                | Решение                           |
| ---------------------- | --------------------------------- |
| Слишком много запросов | Подождите и повторите             |
| Низкий tier            | Пополните счёт для повышения tier |

### Модель недоступна

| Причина              | Решение                            |
| -------------------- | ---------------------------------- |
| Неверное имя модели  | Проверьте ID модели                |
| Нет доступа к модели | Некоторые модели требуют одобрения |

## Рекомендации

### Для большинства задач

Используйте **GPT-4o** — оптимальный баланс качества и цены.

### Для экономии

Используйте **GPT-4o-mini** — значительно дешевле, достаточно для простых задач.

### Для сложной аналитики

Используйте **o1** или **o3** — улучшенные способности к рассуждению.

### Для работы с изображениями

Используйте **GPT-4o** — лучшая поддержка Vision.

## Далее

{% content-ref url="/pages/IHUScfFp4sVHXOTDmzYa" %}
[OpenRouter](/ai-platforma-oneapa/provajdery-llm/openrouter.md)
{% endcontent-ref %}