{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/clipia-ai/json-schema/clipia-ai-result-response-schema.json",
  "title": "ResultResponse",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/clipia-ai-openapi.yml#/components/schemas/ResultResponse",
  "type": "object",
  "required": [
    "request_id",
    "status",
    "model",
    "output",
    "cost",
    "created_at"
  ],
  "properties": {
    "request_id": {
      "type": "string",
      "format": "uuid",
      "description": "Идентификатор запроса генерации."
    },
    "status": {
      "$ref": "#/$defs/GenerationStatus"
    },
    "model": {
      "type": "string",
      "description": "Slug модели, выполнившей генерацию."
    },
    "output": {
      "type": "object",
      "description": "Результат генерации. Для изображений — `images: [{ url, original_url? }]`\n(`url` — оптимизированный WebP для показа; `original_url` — полноразмерный\nоригинал PNG/JPG для скачивания, когда доступен); для видео —\n`video: { url, original_url?, thumbnail_url? }`\n(`thumbnail_url` — статичный кадр-обложка от провайдера, доступен не\nдля всех моделей); для аудио (TTS, музыка) — `audio: { url, format? }` и\n`audios: [{ url, format? }]`. Музыкальные модели отдают несколько вариантов\nтрека за один запрос: `audios` содержит их все, `audio` — первый из них\n(первый элемент `audios` совпадает с `audio`). Все медиа-URL\nведут на CDN `media.clipia.ai`.\n\nПолей `width`, `height` и `duration` в ответе нет: размеры и\nдлительность читайте из самого файла. `original_url` и `thumbnail_url`\nзаполняются не всегда — считайте их опциональными.\n",
      "additionalProperties": true
    },
    "cost": {
      "type": "number",
      "description": "Стоимость генерации в кредитах. Пока запрос в работе — резерв; после завершения — фактически списанное. При `FAILED` и `CANCELED` резерв возвращается, поле равно 0."
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "Время создания запроса (ISO 8601)."
    },
    "completed_at": {
      "type": "string",
      "format": "date-time",
      "description": "Время завершения генерации (ISO 8601)."
    },
    "error": {
      "allOf": [
        {
          "$ref": "#/$defs/GenerationError"
        }
      ],
      "description": "Информация об ошибке (только при `status = FAILED`). Санитизирована."
    },
    "warnings": {
      "$ref": "#/$defs/RequestWarnings"
    }
  },
  "$defs": {
    "GenerationError": {
      "type": "object",
      "description": "Санитизированная ошибка генерации — без деталей внутренней инфраструктуры.\nКредиты за FAILED возвращаются всегда. `code` — закрытый словарь\n(snake_case), по нему клиент решает, повторять ли запрос:\n\n| code | Смысл | Повтор |\n| --- | --- | --- |\n| `generation_failed` | Общая ошибка генерации | можно |\n| `content_moderated` | Запрос отклонён модерацией контента | с тем же вводом бесполезен |\n| `invalid_input` | Ввод не принят моделью (размер/формат/параметры) | исправьте запрос |\n| `model_unavailable` | Модель временно недоступна | позже |\n| `timeout` | Генерация не уложилась во время | можно |\n| `rate_limited` | Модель перегружена | с паузой |\n| `insufficient_credits` | Не хватило кредитов на момент списания | после пополнения |\n| `result_unavailable` | Результат получен, но не сохранён/недоступен | можно |\n| `empty_result` | Модель вернула пустой результат | можно / измените запрос |\n| `canceled` | Отменено пользователем или системой | — |\n",
      "required": [
        "code",
        "message"
      ],
      "properties": {
        "code": {
          "type": "string",
          "enum": [
            "generation_failed",
            "content_moderated",
            "invalid_input",
            "model_unavailable",
            "timeout",
            "rate_limited",
            "insufficient_credits",
            "result_unavailable",
            "empty_result",
            "canceled"
          ]
        },
        "message": {
          "type": "string",
          "description": "Нейтральное описание на английском; без имён внутренних систем."
        }
      }
    },
    "GenerationStatus": {
      "type": "string",
      "description": "Статус генерации в очереди. `CANCELED` — терминальный: генерацию можно отменить вне публичного API (например, из веб-интерфейса Clipia); cancel-эндпоинта в публичном API нет, но `status` может вернуть `CANCELED`, поэтому клиент обязан считать его финальным.",
      "enum": [
        "IN_QUEUE",
        "IN_PROGRESS",
        "COMPLETED",
        "FAILED",
        "CANCELED"
      ]
    },
    "InputWarning": {
      "type": "object",
      "description": "Параметр `input`, который модель не применит.",
      "required": [
        "code",
        "parameter",
        "message"
      ],
      "properties": {
        "code": {
          "type": "string",
          "description": "Машинная причина:\n- `unknown_parameter` — ключ серверу неизвестен (например, опечатка) и\n  отбрасывается у любой модели;\n- `unsupported_parameter` — ключ существует, но эта модель его не\n  объявляет и не использует;\n- `audio_dropped` — звук был включён, но звуковая дорожка не прошла\n  проверку безопасности модели: ролик создаётся без звука, стоимость\n  запроса не меняется. Приходит только в ответах о состоянии запроса\n  (`RequestWarnings`), `parameter` равен `generate_audio`.\n\nСписок причин может пополняться: незнакомое значение обрабатывайте как\n«параметр не применён».\n"
        },
        "parameter": {
          "type": "string",
          "description": "Имя ключа из `input` (длинное имя обрезается до 64 символов)."
        },
        "message": {
          "type": "string",
          "description": "Пояснение на английском: называет параметр и перечисляет параметры,\nкоторые модель объявляет в `input_schema`. Для `audio_dropped` —\nсообщает, что ролик создаётся без звука.\n"
        }
      }
    },
    "RequestWarnings": {
      "type": "array",
      "description": "Предупреждения о ходе исполнения запроса: сервер отступил от параметров\n`input`, чтобы запрос завершился. Сейчас причина одна — `audio_dropped`\n(ролик создаётся без звука). Поле присутствует, только когда есть о чём\nпредупредить, и не приходит при `FAILED` и `CANCELED`. На приёме запроса\nэти предупреждения ещё неизвестны, поэтому в ответе на создание их нет.\n",
      "maxItems": 20,
      "items": {
        "$ref": "#/$defs/InputWarning"
      }
    }
  }
}