.

OPENAI_INTEGRATION.md

@@ -103,10 +103,39 @@ String generatedText = openAIAnalyticsService.generateWithInstruction(data, inst
 
 ## Настройка
 
+### Настройка API ключа
+
 Убедитесь, что в `application.properties` указан корректный API ключ OpenAI:
 
 ```properties
-openai.api.key=your-openai-api-key-here
+openai.api.key=${OPENAI_API_KEY:your-openai-api-key-here}
 ```
 
+**Рекомендуется использовать переменную окружения:**
+
+```bash
+export OPENAI_API_KEY=sk-your-actual-api-key-here
+```
+
+### Тестирование API ключа
+
+Используйте скрипт для проверки API ключа:
+
+```bash
+./test-openai-api.sh
+```
+
+### Решение проблем
+
+**Ошибка 401 Unauthorized:**
+
+- Проверьте правильность API ключа
+- Убедитесь, что ключ не истек
+- Проверьте, что ключ начинается с `sk-`
+
+**Ошибка 429 Rate Limit:**
+
+- Превышен лимит запросов
+- Подождите некоторое время перед повторной попыткой
+
 Модель по умолчанию: `gpt-4o-mini` (можно изменить в настройках).