{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/octen-ai/json-schema/octen-ai-grounded-generation-request-schema.json",
  "title": "GroundedGenerationRequest",
  "description": "Request body for the Grounded Generation API.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/octen-ai-grounded-generation-api-openapi.yml#/components/schemas/GroundedGenerationRequest",
  "type": "object",
  "required": [
    "modality",
    "prompt"
  ],
  "properties": {
    "modality": {
      "type": "string",
      "enum": [
        "image",
        "video"
      ],
      "description": "The type of output to generate."
    },
    "prompt": {
      "type": "string",
      "minLength": 1,
      "maxLength": 8000,
      "description": "The text description of what to generate."
    },
    "model": {
      "type": "string",
      "enum": [
        "google/gemini-3-pro-image",
        "google/gemini-3.1-flash-image",
        "minimax/hailuo-3"
      ],
      "description": "The model to use. When omitted, the model default applies."
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "16:9",
        "1:1",
        "9:16"
      ],
      "default": "16:9",
      "description": "Aspect ratio of the output."
    },
    "duration": {
      "type": "integer",
      "default": 5,
      "minimum": 5,
      "maximum": 10,
      "description": "Video length in seconds. Applies when `modality` is `video`. Values outside the allowed range are adjusted to the nearest bound."
    }
  }
}