{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/videogen-io/json-schema/videogen-io-generate-text-request-schema.json",
  "title": "GenerateTextRequest",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/videogen-io-text-api-openapi.yml#/components/schemas/GenerateTextRequest",
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "description": "The instruction or content to generate text from."
    },
    "system": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional system instructions that steer the model's role, tone, and constraints."
    },
    "quality": {
      "$ref": "#/$defs/ModelQuality",
      "description": "Text generation quality tier. Optional; when omitted, your account's Default AI quality for text is used (change it at https://app.videogen.io/settings/account)."
    },
    "temperature": {
      "type": "number",
      "minimum": 0,
      "maximum": 2,
      "description": "Sampling temperature. Higher values produce more varied output. Defaults to the model's default."
    },
    "maxOutputTokens": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2000,
      "default": 512,
      "description": "Maximum number of tokens to generate. Defaults to 512."
    }
  },
  "$defs": {
    "ModelQuality": {
      "type": "string",
      "enum": [
        "LOW",
        "STANDARD",
        "HIGH",
        "MAX"
      ],
      "description": "AI generation quality tier, shared across every generative feature (image, video, text, and so on). `LOW` is fastest and cheapest, `STANDARD` balances quality and cost, `HIGH` is higher quality, and `MAX` is the highest quality.\n\nWhen a request omits the quality field, VideoGen falls back to your account's **Default AI quality** for that feature, which you can change at [Account settings](https://app.videogen.io/settings/account). Not every feature supports every tier; unsupported tiers are rejected with an error (see each field's description).\n"
    }
  }
}