Это руководство включает обзор кодов ошибок, которые вы можете увидеть как из Справочник API, так и из нашей официальной библиотеки для Python. Каждый упомянутый в обзоре код ошибки имеет свой раздел с дальнейшими инструкциями.
| Код | Обзор |
|---|---|
| 401 - Неверная аутентификация | Причина: Неверная аутентификация Решение: Убедитесь, что используется правильный ключ API и запрашивающая организация. |
| 401 - Предоставлен неверный ключ API | Причина: Запрашиваемый ключ API неверен. Решение: Убедитесь, что используется правильный ключ API, очистите кэш браузера или сгенерируйте новый. |
| 401 - Вы должны быть членом организации, чтобы использовать API | Причина: Ваш аккаунт не является частью организации. Решение: Свяжитесь с нами, чтобы добавить вас в новую организацию, или попросите менеджера вашей организации пригласить вас в организацию. |
| 429 - Достигнут лимит запросов | Причина: Вы отправляете запросы слишком быстро. Решение: Регулируйте частоту ваших запросов. Прочтите Руководство по ограничениям частоты запросов. |
| 429 - Вы превысили вашу текущую квоту, пожалуйста, проверьте ваш план и детали вашего счёта | Причина: Вы израсходовали все кредиты или достигли максимального месячного лимита расходов. Решение: Покупайте больше кредитов или узнайте, как увеличить лимиты. |
| 500 - Сервер столкнулся с ошибкой при обработке вашего запроса | Причина: Проблема на наших серверах. Решение: Попробуйте отправить запрос снова после короткого ожидания и свяжитесь с нами, если проблема сохраняется. |
| 503 - Движок в настоящее время перегружен, пожалуйста, попробуйте позже | Причина: Наши серверы испытывают высокие нагрузки. Решение: Пожалуйста, попробуйте отправить ваши запросы снова после короткого ожидания. |
| Type | Обзор |
|---|---|
| APIConnectionError | Причина: Проблема с подключением к нашим услугам. Решение: Проверьте настройки сети, конфигурацию прокси-сервера, SSL-сертификаты или правила файервола. |
| APITimeoutError | Причина: Время ожидания запроса истекло. Решение: Повторите ваш запрос после короткого времени ожидания и свяжитесь с нами, если проблема сохраняется. |
| AuthenticationError | Причина: Ваш API-ключ или токен был недействителен, истек или был отозван. Решение: Проверьте ваш API-ключ или токен и убедитесь, что он правильный и активный. Возможно, вам нужно будет сгенерировать новый на панели управления вашего аккаунта. |
| BadRequestError | Причина: Ваш запрос был неправильным или в нем не хватало некоторых необходимых параметров, таких как токен или входные данные. Решение: Сообщение об ошибке должно указывать вам на конкретную допущенную ошибку. Проверьте Справочник API для конкретного метода API, который вы вызываете, и убедитесь, что вы отправляете действительные и полные параметры. Вам также может понадобиться проверить кодировку, формат или размер данных вашего запроса. |
| ConflictError | Причина: Ресурс был обновлен другим запросом. Решение: Попробуйте обновить ресурс снова и убедитесь, что другие запросы не пытаются его обновить. |
| InternalServerError | Причина: Проблема на нашей стороне. Решение: Повторите ваш запрос после короткого времени ожидания и свяжитесь с нами, если проблема сохраняется. |
| NotFoundError | Причина: Запрашиваемый ресурс не существует. Решение: Убедитесь, что вы используете правильный идентификатор ресурса. |
| PermissionDeniedError | Причина: У вас нет доступа к запрашиваемому ресурсу. Решение: Убедитесь, что вы используете правильный API-ключ, идентификатор организации и идентификатор ресурса. |
| RateLimitError | Причина: Вы достигли своего лимита скорости. Решение: Регулируйте ваши запросы. Подробнее читайте в нашем Руководстве по лимитам скорости. |
| UnprocessableEntityError | Причина: Невозможно обработать запрос, несмотря на правильный формат. Решение: Пожалуйста, повторите запрос снова. |
- Модель, которую вы использовали
- Сообщение об ошибке и код, который вы получили
- Данные и заголовки запроса, которые вы отправили
- Отметка времени и часовой пояс вашего запроса
- Любые другие соответствующие детали, которые могут помочь нам диагностировать проблему
Наша служба поддержки расследует проблему и свяжется с вами как можно скорее. Обратите внимание, что время ожидания нашей службы поддержки может быть долгим из-за высокого спроса.
Мы рекомендуем программно обрабатывать ошибки, возвращаемые API. Для этого вы можете использовать фрагмент кода, подобный приведенному ниже:
1import openai
2from openai import OpenAI
3client = OpenAI()
4
5try:
6 #Сделайте ваш запрос к API OpenAI здесь
7 response = client.completions.create(
8 prompt="Hello world",
9 model="gpt-3.5-turbo-instruct"
10 )
11except openai.APIError as e:
12 #Обработайте ошибку API здесь, например, повторите попытку или ведите лог
13 print(f"API OpenAI вернуло ошибку API: {e}")
14 pass
15except openai.APIConnectionError as e:
16 #Обработайте ошибку подключения здесь
17 print(f"Не удалось подключиться к API OpenAI: {e}")
18 pass
19except openai.RateLimitError as e:
20 #Обработайте ошибку превышения лимита запросов (мы рекомендуем использовать экспоненциальное откатывание)
21 print(f"Запрос к API OpenAI превысил лимит запросов: {e}")
22 pass