---
title: "Генерация завершилась ошибкой"
method: POST
path: "generation.failed"
---

# Генерация завершилась ошибкой

`POST generation.failed` (webhook)

Если при `submit` был передан `webhook_url`, Clipia отправит `POST` на
этот URL при ошибке генерации. Кредиты при этом возвращены.

Заголовки подписи и правила доставки идентичны `generation.completed`
(HMAC-SHA256, `X-Clipia-Signature`, окно свежести, ретраи).

## Headers

- `X-Clipia-Webhook-Id` string, uuid, required
- `X-Clipia-Timestamp` integer, required
- `X-Clipia-Signature` string, required

## Payload

- WebhookError: Payload вебхука об ошибке генерации (кредиты возвращены).
  - `request_id` string, uuid, required
  - `status` 'ERROR', required: Признак ошибки.
  - `error` GenerationError, required: Санитизированная ошибка генерации — без деталей внутренней инфраструктуры. Кредиты за FAILED возвращаются всегда. `code` — закрытый словарь (snake_case), по нему клиент решает, повторять ли запрос: | code | Смысл | Повтор | | --- | --- | --- | | `generation_failed` | Общая ошибка генерации | можно | | `content_moderated` | Запрос отклонён модерацией контента | с тем же вводом бесполезен | | `invalid_input` | Ввод не принят моделью (размер/формат/параметры) | исправьте запрос | | `model_unavailable` | Модель временно недоступна | позже | | `timeout` | Генерация не уложилась во время | можно | | `rate_limited` | Модель перегружена | с паузой | | `insufficient_credits` | Не хватило кредитов на момент списания | после пополнения | | `result_unavailable` | Результат получен, но не сохранён/недоступен | можно | | `empty_result` | Модель вернула пустой результат | можно / измените запрос | | `canceled` | Отменено пользователем или системой | — |
    - `code` 'generation_failed' | 'content_moderated' | 'invalid_input' | 'model_unavailable' | 'timeout' | 'rate_limited' | 'insufficient_credits' | 'result_unavailable' | 'empty_result' | 'canceled', required
    - `message` string, required: Нейтральное описание на английском; без имён внутренних систем.

## Acknowledgement `200`

Доставка принята получателем.

---

[API](https://skmtc.dev/clipia/apis/clipia-api.md) · [All operations](https://skmtc.dev/clipia/apis/clipia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clipia/apis/clipia-api/revisions/cc55924a3381?raw)