Таймаут — не повод платить второй раз: как устроить повтор AI-задачи
Генерация изображения зависла. Интерфейс показывает ошибку и предлагает нажать «Повторить». Пользователь нажимает — и вместо проверки первой задачи получает вторую платную попытку. Разберу, как согласовать интерфейс, API и состояние задачи, чтобы неопределённость не превращалась в повторную оплату.
Иллюстрация сгенерирована в GPT Image 2. Визуальная метафора, не схема реализации.
Кнопка «Повторить» скрывает два разных действия
После таймаута пользователь обычно хочет получить ответ на вопрос: «Что стало с моей задачей?» Но кнопка может отправлять совершенно другую команду: «Создай ещё одну».
Для генерации видео или изображения разница принципиальная. Пока браузер уже показывает ошибку, внешняя система может продолжать работу.
Здесь важно не обещать лишнего: таймаут сам по себе не доказывает ни успех, ни отказ, ни списание денег. Он означает, что в отведённое время мы не получили достаточного ответа.
Поэтому я бы разделял действия прямо в продукте:
- «Проверить статус» — прочитать состояние существующей задачи.
- «Новая генерация» — создать отдельную задачу с новым расходом в рамках правил сервиса.
Это проектный разбор, а не отчёт о замерах конкретной платформы. Ниже — пример контракта для собственного бэкенда.
Сначала сохраните намерение, потом вызывайте модель
Если единственный идентификатор задачи приходит от провайдера, при потере ответа у приложения может не остаться ничего, за что можно зацепиться.
Я бы создавал собственный operation_id до внешнего вызова. Вместе с ним в устойчивом хранилище нужны владелец, параметры запроса, состояние и ссылка на резерв бюджета, если он используется.
Упрощённый порядок:
- Приложение получает команду на генерацию.
- В транзакции создаёт операцию и запись на отправку в очередь.
- Фоновый обработчик обращается к провайдеру.
- Приложение связывает свою операцию с внешним идентификатором, когда тот получен.
Операцию и запись на отправку стоит фиксировать атомарно, например через transactional outbox. Иначе между сохранением задачи и постановкой в очередь появится ещё одно окно сбоя.
Но outbox не даёт магии exactly-once: повторная доставка сообщения всё равно требует защиты на стороне обработчика и, где возможно, внешнего API.
Один пользовательский запуск — один ключ
Для повторной доставки той же команды можно предусмотреть ключ идемпотентности:
POST /api/generations Idempotency-Key: <ключ-пользовательского-запуска>
Идея контракта: одинаковый ключ в области одного пользователя возвращает ту же операцию, а не создаёт новую.
Ключ нужно подготовить до первой отправки и сохранить так, чтобы сетевой retry не генерировал новый. Если интерфейс создаёт новый UUID при каждом клике, заголовок выглядит правильно, но от дубликатов не защищает.
На бэкенде понадобятся:
- уникальное ограничение на пару «пользователь — ключ»;
- отпечаток значимых параметров запроса;
- проверка владельца при чтении операции;
- определённый срок хранения ключей.
Повтор с тем же ключом, но другим промптом или моделью я бы отклонял с 409 Conflict, а не молча трактовал как прежнюю задачу.
Это поведение нашего API. Наличие такого же заголовка у внешнего провайдера, срок его действия и правила повторов нужно проверять отдельно. После удаления старого ключа повтор уже может стать новым запуском.
Ответ «принято» не означает «выполнено»
Для асинхронного контракта можно вернуть:
HTTP/1.1 202 Accepted Location: /api/generations/op_7f3a Content-Type: application/json { "operation_id": "op_7f3a", "status": "queued", "status_url": "/api/generations/op_7f3a" }
Это пример ответа, не результат реального запроса.
202 Accepted означает принятие к обработке, но не гарантирует завершения. Поэтому клиенту нужен адрес проверки состояния, а серверу — устойчивый учёт операции.
Чтение GET /api/generations/op_7f3a в таком контракте не запускает модель заново. Оно возвращает известное состояние.
Если браузер не получил даже первоначальный ответ с operation_id, повторный POST с сохранённым ключом должен позволить найти уже созданную операцию. Одной страницы истории для этого недостаточно.
Состояние «результат уточняется» должно быть настоящим
Я бы не сводил все ситуации к двум значениям: success и error.
СостояниеЧто показыватьСледующее действиеqueued / runningЗадача принята или выполняетсяПроверять ту же операциюunknownИсход внешнего вызова уточняетсяСверять состояние, не запускать автоматически зановоsucceededРезультат готовОткрыть результатfailed_confirmedОбработка завершилась отказомОтдельно предложить новую попытку
В этой модели failed_confirmed — отказ именно обработки, а не просто неудачная попытка прочитать статус. Он также не означает автоматически, что услуга бесплатна: финансовый итог нужно учитывать отдельно.
Практический текст для unknown:
Ответ от сервиса не получен. Проверяем, была ли задача принята. Автоматический повторный запуск не выполняется.
Если резерв действительно удерживается, это тоже можно показать. Но нельзя писать «деньги не списаны», когда система этого ещё не знает.
Самое неприятное окно — после принятия запроса провайдером
Представим: внешний сервис принял генерацию, но наш процесс завершился раньше, чем сохранил внешний идентификатор.
В собственной базе есть операция. Внешний результат может существовать. Связи между ними пока нет.
Если провайдер поддерживает документированную идемпотентность или поиск по клиентскому идентификатору, это помогает восстановить связь. Если нет — безопасно повторить платный вызов удаётся не всегда.
Именно здесь автоматический retry может создать второй расход. Локальный ключ идемпотентности сам по себе не превращает внешний вызов в идемпотентный.
Для такого случая нужны сверка по доступным данным и путь ручного разбора. Кнопка в браузере этого окна не устраняет.
Не превращайте ожидание в бесконечную заглушку
«Уточняем результат» честнее ложного отказа, но это не разрешение забыть задачу.
Нужны ответственный обработчик, расписание проверок и срок, после которого вопрос эскалируется человеку или переводится в явно обозначенное неразрешённое состояние.
При этом истечение внутреннего срока сверки не доказывает, что внешняя генерация не состоялась. Не стоит автоматически отпускать резерв только потому, что закончился таймер проверки.
Отмена тоже требует точного текста. «Перестать ждать» на стороне клиента — не то же самое, что подтверждённая отмена обработки у провайдера.
Что проверить перед выпуском
Для этой схемы я бы отдельно прогнал следующие сценарии. Это список проверок, а не заявление об уже выполненных тестах:
- два одновременных запроса с одним ключом создают одну операцию;
- изменённые параметры с прежним ключом не принимаются как прежняя команда;
- потеря первоначального ответа не вынуждает создавать новый запуск;
- перезагрузка страницы сохраняет доступ к истории задач;
- другой пользователь не может прочитать чужую операцию;
- повторная доставка задания не вызывает незаметную вторую генерацию;
- сбой между внешним принятием и локальным сохранением не ведёт к безусловному retry;
- состояние unknown попадает в сверку и не исчезает из наблюдения.
История операций особенно важна для нескольких вкладок. Блокировка одной кнопки — только удобство интерфейса, а не серверная защита от повторов.
Главное
Я бы начинал не с надписи на кнопке, а с вопроса: что именно повторяется — чтение состояния или платная работа?
Проверка статуса, повторная доставка прежней команды и новый пользовательский запуск — три разных действия. У них должны различаться контракт, идентификаторы и последствия.
Хороший интерфейс не обещает невозможного. Он помогает понять, что уже известно, что ещё проверяется и какое действие действительно создаст новую попытку.
А у вас после таймаута пользователь видит свою прежнюю задачу — или только кнопку, которая незаметно создаёт следующую?
Источники
Предложенные состояния, названия кнопок и API-контракт — проектные рекомендации, а не требования RFC.