Идемпотентность
Безопасный повтор после timeout без двойной генерации и оплаты.
createTask и retry поддерживают заголовок Idempotency-Key. Для createTask ключ привязан к логическому запросу аккаунта, для retry — к исходной задаче и действию повтора. Это предотвращает дублирующую генерацию и оплату.
POST /api/v1/jobs/createTask
Idempotency-Key: order-8814-render-1
POST /api/v1/jobs/retry
Idempotency-Key: retry-order-8814-1Окно 24 часа
Ключ действует 24 часа. Создавайте один ключ на логический запрос и используйте его во всех повторах, включая сетевой timeout. Максимальная длина — 128 символов.
Ключ связан с запросом
Отпечаток включает model, канонический input, callBackUrl. Тот же ключ с другим payload возвращает HTTP 409. Разный порядок ключей JSON и пробелы не делают запрос новым.
Одновременные запросы
Уникальное ограничение базы гарантирует одну задачу, если два запроса пришли одновременно. При редкой гонке 409 подождите несколько сотен миллисекунд и повторите с тем же ключом. Текущее состояние проверяйте через recordInfo по полученному taskId.
Полные определения полей приведены в контракте OpenAPI 3.1.