Ошибки и повторы API ИИ: не создавайте вторую проблему
Отличайте ошибки, требующие исправления, от временных сбоев и не дублируйте асинхронные задачи.

Сначала прочитайте ошибку
Неверный формат запроса, недействительный ключ или неподдерживаемый параметр обычно требуют исправления, а не повторной отправки. При ограничении частоты и временной ошибке повтор может быть уместен по документации. Сохраняйте статус и ID запроса, не записывая ключи и чувствительные промпты.
Проблемы аутентификации и прав требуют проверки ключа и доступа. Неверный формат, название модели или параметр требуют исправления запроса. Ограничение частоты и временный сбой иногда допускают повтор по документации. Если всё назвать ошибкой сети, полезные сведения исчезнут, а бессмысленные повторы станут вероятнее.
Дайте сервису время восстановиться
Для допустимых повторов задайте ограничение числа попыток, растущую задержку и случайный разброс. Учитывайте задержку, указанную сервером, и общий срок ожидания. Не повторяйте все ошибки подряд и не допускайте одновременного повторного пика от множества клиентов.
Для ошибок, которые документация разрешает повторять, ограничьте попытки и общее время, увеличивайте задержку и добавляйте случайный разброс. Учитывайте явную задержку сервера. Пользователь должен иметь возможность отменить операцию; после достижения предела прекращайте работу вместо бесконечного расходования ресурсов.
При временном сбое повтор выполняется с задержкой и по заданной стратегии.Будьте осторожны с побочными эффектами
Тайм-аут возможен уже после принятия запроса. Вторая задача изображения или видео может продублировать работу и стоимость. Сохраняйте возвращённый ID и по возможности проверяйте исходную задачу перед повторной отправкой. Используйте идемпотентность только там, где она явно описана.
Тайм-аут после отправки может означать потерю ответа при уже созданной удалённой задаче. Сохраните и проверьте ID, если получили его; без ID не считайте задачу заведомо отсутствующей. Узнайте, документирует ли интерфейс поиск, callback или идемпотентность, и следуйте процедуре восстановления. До новой отправки объясните возможные дополнительные расходы.
Подскажите пользователю следующий шаг
Объясните, можно ли повторить запрос, изменить ввод или вернуться позже. При необходимости сохраните частичный потоковый ответ и отметьте его как незавершённый. Отдельно проверьте неверный запрос, ограничение частоты, обрыв сети и задержку задачи: им не подходит одно общее сообщение.
Время, ID запроса, интерфейс, статус, длительность и категория ошибки часто достаточны для начала расследования. Не записывайте полные ключи, заголовки авторизации и лишние промпты; проверяйте личные данные перед передачей журнала. Пользователю нужен следующий шаг, а сопровождающему — ограниченный, но отслеживаемый контекст.
Отдельно смоделируйте неверный параметр, ошибку входа, ограничение частоты, обрыв и медленную асинхронную задачу. Проверьте, что повторяются только подходящие ошибки, задержки ограничены и частичные результаты сохраняются при необходимости. Проверьте многократное нажатие повтора на дубликаты. Для учения не нужны данные клиентов или платные задачи в production.
Определите тип ошибки
Сохраните код состояния, идентификатор, время и обезличенную категорию ошибки. При проблеме авторизации проверьте ключ и права, при неверных параметрах исправьте запрос. Ограничение частоты или временный сбой могут допускать повтор согласно документации.
Тайм-аут после отправки не доказывает, что удалённый сервис ничего не сделал. Задача может выполняться или уже завершиться. Объясните пользователю дальнейшие действия без раскрытия секретов и внутренних трассировок.
Ограничьте повторные попытки
Для безопасных повторов задайте максимальное число попыток и общий срок ожидания. Увеличивающийся интервал со случайным разбросом снижает вероятность одновременного повтора многими клиентами. Учитывайте рекомендации API.
Не умножайте повторы одновременно в браузере, сервере и библиотеке. Для создания или изменения используйте реально поддерживаемую идемпотентность либо проверяйте известную задачу. Если результат неясен, сообщите об этом.
Проверьте стратегию на двух примерах
При явном ограничении частоты сохраните ввод, соблюдайте интервал и предел попыток, разрешите отмену. После неудачи остановите индикатор и объясните ситуацию.
Если соединение оборвалось до получения идентификатора видео, используйте предусмотренное восстановление и не создавайте несколько задач молча. Проверьте неверный ключ, параметры и отмену; настройте оповещения по длительности и влиянию.
Два сбоя требуют разных действий
При ограничении частоты и указанной сервером задержке подождите в пределах политики повторов. Если создание видео завершилось тайм-аутом после отправки, задача уже могла появиться: найдите сохранённый ID и проверьте её состояние. Если ID не получен, сообщите о неопределённости и следуйте документации, не предполагая бесплатный повтор.
При обращении укажите время, модель, ID запроса и обезличенное описание ошибки. Не просите пользователя публиковать ключ или полный частный контент. До рекомендации безопасного повтора выясните, не была ли задача уже создана.