{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/clipia-ai/json-schema/clipia-ai-submit-response-schema.json",
  "title": "SubmitResponse",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/clipia-ai-openapi.yml#/components/schemas/SubmitResponse",
  "type": "object",
  "required": [
    "request_id",
    "status",
    "status_url",
    "response_url",
    "cost"
  ],
  "properties": {
    "request_id": {
      "type": "string",
      "format": "uuid",
      "description": "Идентификатор запроса генерации."
    },
    "status": {
      "$ref": "#/$defs/GenerationStatus"
    },
    "queue_position": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Позиция в очереди (если запрос в очереди)."
    },
    "status_url": {
      "type": "string",
      "format": "uri",
      "description": "Ссылка для проверки статуса."
    },
    "response_url": {
      "type": "string",
      "format": "uri",
      "description": "Ссылка для получения результата."
    },
    "cost": {
      "type": "number",
      "description": "Фиксированная стоимость операции в кредитах (резервируется при submit)."
    },
    "warnings": {
      "$ref": "#/$defs/InputWarnings"
    }
  },
  "$defs": {
    "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"
        }
      }
    },
    "InputWarnings": {
      "type": "array",
      "description": "Параметры `input`, которые модель не применит: по элементу на ключ, не\nбольше 20 элементов. Поле присутствует, только когда такие параметры есть.\n",
      "maxItems": 20,
      "items": {
        "$ref": "#/$defs/InputWarning"
      }
    }
  }
}