Устранение неполадок
Решения распространенных проблем и советы по устранению неполадок
В этом разделе описаны распространенные проблемы, с которыми вы можете столкнуться при использовании Qwen Image Edit, и способы их устранения.
1. Ошибки аутентификации
Недействительный ключ API
Убедитесь, что ваш ключ API настроен правильно. Если ключ недействителен или истек, вам может потребоваться сгенерировать новый.
Неподдерживаемый регион
Убедитесь, что ваши запросы API отправляются в поддерживаемый регион. Список поддерживаемых регионов см. в Справочнике API.
2. Проблемы с квотами и ограничениями скорости
Недостаточно кредитов
Убедитесь, что на вашем аккаунте достаточно кредитов. Если кредитов недостаточно, вам может потребоваться приобрести дополнительные.
Превышение ограничения скорости
Отправка слишком большого количества запросов за короткий промежуток времени может привести к превышению ограничения скорости. Внедрите задержки между запросами или используйте пакетную обработку, чтобы избежать превышения ограничения скорости.
3. Проблемы, связанные с изображениями
Изображение слишком большое
Убедитесь, что размер изображения, которое вы пытаетесь обработать, не превышает ограничения API. Большие изображения могут потребовать изменения размера или сжатия перед обработкой.
Неподдерживаемый формат изображения
Убедитесь, что вы используете формат изображения, поддерживаемый API (например, JPEG, PNG). Список поддерживаемых форматов см. в Справочнике API.
4. Проблемы с сетью
Время ожидания соединения
Убедитесь, что ваше сетевое соединение стабильно. Настройки брандмауэра или прокси-сервера могут блокировать соединение с API.
Ошибка сети
Возможно, произошла временная проблема с сетью. Подождите немного и повторите запрос.
5. Сбои обработки
Сбой обработки
Если обработка изображения не удалась, убедитесь, что входное изображение является действительным и соответствует требованиям API. Проверьте ответ API для получения более подробной информации.
Контент не обнаружен
Убедитесь, что контент (текст или элемент), который вы пытаетесь отредактировать, четко идентифицируется на изображении. Если контент неоднозначен или слишком мал, API может его не обнаружить.
6. Проблемы с производительностью
Медленная обработка
Если обработка медленная, рассмотрите следующее:
- Оптимизация размера изображения.
- Использование пакетной обработки.
- Использование более быстрого сетевого соединения.
Недостаточно памяти
При обработке больших изображений могут возникать ошибки нехватки памяти. Убедитесь, что в вашей системе достаточно памяти, или рассмотрите возможность обработки изображений меньшего размера.
7. Инструменты отладки
Подробное логирование
Включите подробное логирование в вашем API-клиенте, чтобы получить подробную информацию о запросах и ответах. Это поможет выявить первопричину проблемы.
Перехватчик запросов
Используйте перехватчик запросов, чтобы убедиться, что ваши запросы API правильно сформированы и содержат все необходимые заголовки и параметры.
Проверка работоспособности
Используйте конечную точку проверки работоспособности API, чтобы убедиться, что служба работает правильно.
8. Поддержка
Если описанные выше шаги не помогли решить проблему, обратитесь в нашу службу поддержки. Предоставьте все соответствующие сообщения об ошибках, идентификаторы запросов и журналы, чтобы помочь нам диагностировать проблему.