GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
Все руководства

· reAPI Team

Ошибки API 500: когда повторять видеозапрос

Обрабатывай ошибки API 500, не создавая дубликаты платных видеозадач. Проверь, был ли запрос принят, восстанови ID задачи, ограничь повторы и безопасно возобнови рабочие процессы.

Ошибки API 500: когда повторять видеозапрос

Один щелчок, сообщение об ошибке, затем ещё один щелчок. В видеоприложении этого может хватить, чтобы создать две платные генерации, хотя интерфейс по-прежнему показывает сбой.

Представь гипотетический запрос: сервер принимает первую отправку, запускает задачу и теряет ответ по пути обратно к клиенту. Клиент получает ошибку и отправляет запрос снова. Если конечная точка создаёт новую задачу для каждой принятой отправки, обе задачи могут продолжить выполняться. Второй щелчок не исправил первый ответ — он запросил ещё одно видео.

В этом и состоит практическая сложность ошибок API 500. В рекомендациях AWS по повторам сказано, что неудачный ответ или превышение времени ожидания не доказывают отсутствия побочных эффектов операции.[1] Прежде чем повторять генерацию, выясни, что делал неудачный запрос и какие свидетельства его принятия сохранились.

Найди запрос, который завершился ошибкой

Сообщение вроде «Request failed with status code 500» указывает на результат HTTP, а не на состояние видео. MDN определяет 500 как неожиданное состояние сервера, помешавшее выполнить запрос.[2] Оно не сообщает, какой компонент дал сбой, не доказывает, что все входные данные были допустимы, и не обещает, что ожидание исправит проблему.

Посмотри на метод и URL в журнале клиента. Сбой POST-запроса на генерацию имеет другие последствия, чем сбой при получении существующей задачи. Загрузка файла может завершиться ошибкой уже после успешного выполнения обеих этих операций. Интерфейс, который объединяет все три случая под сообщением «генерация не удалась», теряет различие, необходимое для восстановления.

Сохрани время UTC, модель, статус, тело ответа и доступный идентификатор запроса или задачи. Перед тем как поделиться журналами, удали учётные данные. Если вместо документированного формата ошибки API получен HTML, сохрани и этот факт; не делай вывод о сбое модели по общей странице ошибки.

Для гипотетического первого щелчка вопрос в том, есть ли у тебя ID задачи. Найди сохранённый сервером ответ на отправку, вывод соответствующего рабочего процесса и любую документированную запись обратного вызова. Проверь учётную запись или проект, откуда действительно был отправлен запрос. Другая учётная запись в панели не поможет определить, создала ли эта отправка задачу.

Если есть ID задачи, продолжай с неё

Если ты восстановил идентификатор, используй документированную операцию чтения поставщика. В reAPI запрос GET /api/v1/tasks/{id} возвращает задачу без расходования кредитов.[3] Именно так следует продолжать наблюдение; повторная отправка исходного тела запроса на генерацию создаёт отдельную отправку.

Посмотри состояние задачи в ответе. reAPI возвращает HTTP 200, когда задача найдена, в том числе если её состояние — failed.[4] Следовательно, HTTP 200 не означает, что видео создано успешно. И наоборот, 500 при проверке задачи не доказывает, что видео не удалось создать. Это означает, что проверка не дала полезного ответа.

Обрабатывай завершённую задачу с помощью документированных полей результата. Сохрани нужный файл, а не оставляй приложение ждать второй генерации. За задачей в процессе продолжай наблюдать. Для неудачной задачи изучи ошибку и сведения о расчётах, прежде чем решать, имеет ли смысл новая попытка.

Неудачная задача и её оплата связаны, но это разные вещи. reAPI описывает возврат средств за неудачные задачи и отдельные случаи, характерные для конкретных моделей, когда проверка безопасности после генерации может заблокировать результат уже после выполнения генерации, подлежащей оплате.[3] Сохрани фактическую запись об использовании для этой задачи. Общее сообщение «ошибка сервера» не доказывает, что все списания должны исчезнуть; оплату неудачных генераций нужно оценивать по конечному состоянию задачи и применимой политике.

Если ID нет, оставь принятие запроса неразрешённым

Более сложный случай — первый щелчок без пригодного ответа на отправку. Явно присвой этой операции в приложении неразрешённое состояние. Например, внутреннее значение acceptance_unknown может отличать её от работы, которую вообще не отправляли, и работы, для которой поставщик подтвердил сбой. Это предлагаемое состояние приложения, а не поле, которое возвращает каждый API.

Сохраняй стабильный локальный ID операции и назначь одного ответственного за восстановление. Он может сверить свидетельства, которые действительно предоставляет интеграция: сохранённые ответы, обратные вызовы, историю задач, доступную по разрешению, или результаты обращения в поддержку. Если задачу удастся определить позже, свяжи её с исходной операцией и продолжай с этого места.

Пустой столбец локального ID задачи доказывает только то, что приложение не сохранило ID. Ответ мог потеряться после принятия запроса. Аналогично, локальный ID операции не передаётся поставщику автоматически и не заставляет его конечную точку создания устранять дубликаты запросов. Он помогает упорядочить свидетельства, но не доказывает выполнение ровно один раз.

Так же осторожно относись к заголовку Idempotency-Key. HTTP POST сам по себе не идемпотентен, а безопасность повтора зависит от фактического контракта конечной точки.[5] reAPI прямо сообщает, что записывает этот заголовок, но не использует его для устранения дубликатов генераций. Повторная отправка принятого POST с тем же ключом может создать ещё одну задачу и ещё одно списание.[6]

Если свидетельства остаются неубедительными, намеренно создать замену всё ещё может быть деловым решением. Запиши её как отдельную попытку, связанную с исходной неразрешённой операцией, и учитывай вероятность завершения обеих. Не меняй незаметно статус первой попытки на «не создана» только ради упрощения очереди повторов. Так ты сотрёшь именно ту запись, которая нужна, если результат или списание появятся позже.

Проверь, что именно повторит n8n

В редакторе рабочего процесса ту же неоднозначность легко не заметить. Узел с названием «Generate Video» может отправить работу, а затем ждать результата. Красный узел может означать, что время ожидания закончилось, хотя удалённое предсказание продолжает выполняться.

В официальной документации интеграции WaveSpeed с n8n описано именно такое поведение: узел генерации отправляет предсказание и ждёт результат. Положительное значение времени ожидания может привести к сбою узла, пока предсказание продолжает выполняться. Документация предупреждает, что Retry On Fail в n8n запускает весь узел заново и создаёт новое предсказание с отдельной оплатой; временные сбои опроса уже повторяются внутренним механизмом.[7] Это предупреждение относится к данной интеграции и не распространяется автоматически на каждый узел сообщества.

Если рабочий процесс построен на узлах HTTP Request, проверь, что делает узел, для которого настроены повторы. В документации n8n Retry on Fail описан как настройка на уровне узла.[8] Если этот узел отправляет POST-запрос на генерацию, новая попытка снова отправит этот POST. Если он только читает известную задачу, повторяется чтение. Видимый текст ошибки рабочего процесса не заменяет проверку узла.

Практичный вариант — сохранять ID принятой задачи между отправкой и опросом. Тогда восстановление сможет продолжиться с этапа чтения, не проходя создание заново. Это не решает описанный выше случай потери ответа на отправку; сохраняй этот неразрешённый путь отдельно. Ручной перезапуск всего выполнения тоже требует такой проверки, поскольку ранее успешно выполненные шаги создания могут запуститься повторно.

Вернёмся к гипотетическому двойному щелчку: замена второго щелчка автоматическим повтором узла не меняет проблему оплаты. Приложению всё ещё нужно знать, запрашивает ли оно сведения об исходной задаче или просит создать новую.

Повторяй чтение с точкой остановки

Временный сбой при чтении известной задачи — более очевидный повод для повтора. Используй тот же идентификатор задачи, соблюдай документированные правила опроса и ограничения частоты запросов для конечной точки и останавливай цикл немедленных повторов, когда исчерпано допустимое число попыток или бюджет времени.

AWS описывает ограниченную экспоненциальную задержку, случайный разброс и ограничения числа попыток, чтобы не перегружать нестабильную зависимость.[1] Случайный разброс распределяет следующие попытки клиентов во времени, а не назначает их все на один момент. Эти методы управляют нагрузкой от повторов, но не превращают POST создания в операцию с устранением дубликатов.

Назначь один уровень ответственным за это восстановление. Если SDK, узел рабочего процесса и внешний рабочий процессор независимо повторяют запросы, фактический трафик может превысить ожидания, которые создаёт внешняя настройка. Прежде чем добавлять ещё один цикл, проверь уже встроенные в интеграцию повторы.

Когда бюджет чтения исчерпан, сохрани ID задачи для последующей сверки. Крайний срок клиента показывает, как долго ждал этот клиент. Если документированная операция отмены не завершилась успешно, это не доказывает, что удалённая генерация остановилась. Покажи неразрешённое состояние получения результата, а не безусловную кнопку «Повторить», которая отправит новую работу.

Изучи конкретную ошибку перед выбором замены

Получив структурированную ошибку, прочитай её код и документированную область действия. Например, reAPI указывает 60001 и 60002 как сбои сохранения задачи или запуска рабочего процесса, за которые возвращаются кредиты.[4] Эти документированные случаи дают основание для иного решения о восстановлении, чем неизвестный HTML-ответ 500 или потеря соединения после отправки. Не распространяй возврат средств на все ошибки сервера.

Если в конкретном ответе указаны недопустимые входные данные или непригодные медиафайлы, исправь указанную проблему в соответствии с документацией этой конечной точки, прежде чем отправлять новую попытку. Сохрани свидетельства исходной попытки и считай исправленную отправку новой работой; изменение входных данных не разрешает неопределённость относительно принятия предыдущего запроса.

Фраза «Сервер сейчас не может обработать этот запрос» тоже недостаточна без HTTP-статуса и подробностей ответа. Многократное изменение промпта, обновление браузера или увеличение времени ожидания не показывают, где именно произошёл сбой на стороне сервера. Для конечной точки, которой управляет поставщик, передай через его процесс поддержки метод, URL, время UTC и доступные идентификаторы; руководство по ошибкам reAPI указывает эти свидетельства.[4]

Другой поставщик может стать полезной заменой, если поддерживаемые им входные данные, выходные данные и условия работы подходят для задачи. Но одно лишь другое имя хоста не доказывает, что путь сбоя независим. Успешная замена также не объясняет, что произошло с исходной отправкой. Сохраняй видимыми обе попытки, включая исходную задачу, которая завершится позже.

Прежде чем возобновлять очередь накопившихся задач, учти уже отправленную работу. За известными задачами нужно продолжать наблюдать или зафиксировать их результат; для неизвестных отправок нужны ответственный и явное решение о замене. Первый успешный повтор полезен, но восстановление можно понять, только если ты можешь объяснить, какие удалённые задачи могут существовать для каждого запроса пользователя.

Источники

  1. AWS Builders Library: Timeouts, retries, and backoff with jitter. Инженерные рекомендации, впервые опубликованные в 2019 году; побочные эффекты, ограниченные повторы и усиление нагрузки из-за повторов.
  2. MDN: HTTP 500 Internal Server Error. Определение и расследование на стороне сервера.
  3. reAPI Tasks. Опрос, статус, результат и семантика расчётов.
  4. reAPI Errors. Конкретные коды сбоев и свидетельства для поддержки. Решения о повторах здесь также учитывают контракт отправки из источника 6.
  5. MDN: Idempotent. Семантика методов HTTP и ограничения предположения о безопасности повтора.
  6. Обзор API reAPI. Отправка генерации и контракт Idempotency-Key.
  7. Официальная документация интеграции WaveSpeed с n8n. Тайм-аут узла, повторы всего узла и отдельно оплачиваемые предсказания; просмотрено 15 ноября 2026 года.
  8. Официальная документация n8n по распространённым проблемам HTTP Request. Retry on Fail и настройки повторов узла; просмотрено 15 ноября 2026 года.
Все руководства