ДокументацияИдемпотентность

Идемпотентность

Как не создать и не оплатить запрос дважды.

Вся документация для ИИ →

Сеть рвётся: запрос мог дойти, а ответ — нет. Чтобы повтор не создал второй ролик и не списал деньги дважды, передавайте заголовок Idempotency-Key:

bash
-H "Idempotency-Key: order-1842-video"
  • Ключ — от 8 до 128 печатных символов ASCII: UUID или ваш номер заказа.
  • Повтор с тем же ключом возвращает первый запрос с заголовком Idempotent-Replayed: true — без новой генерации и списания.
  • Если первый запрос ещё создаётся, повтор получит 409 idempotency_conflict — повторите через пару секунд.
  • Если первый запрос не был создан или модель отказалась его запускать (ответ с ошибкой), ключ свободен: повтор с ним создаёт запрос заново.
  • Ключ действует для аккаунта навсегда: новый ролик — новый ключ.
Идемпотентность — Outsee API