# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onerpa.ru/ai-platforma-oneapa/provajdery-llm/openai.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.