Проверьте статус
GET /v1/jobs возвращает до 50 заданий владельца ключа в его проекте. Для продолжения передайте after=next_cursor. GET /v1/jobs/ID возвращает одно задание. Нужен ключ с правом jobs:read.
Сохраните ID из ответа на генерацию в KVANTORA_JOB_ID. Запрос ниже только читает статус и не запускает генерацию повторно.
Billing содержит estimated_cost_microrub и cost_microrub. Null в cost_microrub означает, что списание не подтверждено; не считайте его нулевой стоимостью.
Получите результат или отмените задание
Послеsucceeded используйте output.file_id по инструкции для файлов. До этого состояния не считайте результат готовым. При unknown продолжайте проверять прежнее задание и сохраняйте его ID для поддержки.
POST /v1/jobs/ID/cancel отменяет только задание до отправки запроса модели. После возможной платной отправки ответ 409; это не повод повторять генерацию с новым ID. Повтор отмены безопасен.
Сервис сохраняет результат и связь с приватным файлом. После перезапуска он продолжает проверять то же задание, не отправляя платный запрос заново. Подробнее об уведомлениях: webhooks.