{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/vee3-io/json-schema/vee3-io-generate-image-request-schema.json",
  "title": "GenerateImageRequest",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/vee3-io-image-generation-api-openapi.yml#/components/schemas/GenerateImageRequest",
  "properties": {
    "prompt": {
      "type": "string",
      "maxLength": 4000,
      "title": "Prompt",
      "description": "Text description of the image to generate or of the edit to apply."
    },
    "n": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 10.0,
          "minimum": 1.0
        },
        {
          "type": "null"
        }
      ],
      "title": "N",
      "description": "Number of images to generate (1 to 10). Each returned image costs 50 tokens.",
      "default": 1
    },
    "size": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 32
        },
        {
          "type": "null"
        }
      ],
      "title": "Size",
      "description": "Optional output size as WIDTHxHEIGHT (for example 1024x1536) or auto. This sets aspect ratio, not exact pixel size. Omit for the default aspect ratio."
    },
    "output_format": {
      "type": "string",
      "enum": [
        "webp",
        "png",
        "jpeg"
      ],
      "title": "Output Format",
      "description": "Encoding of the returned image. webp is smaller; png is lossless.",
      "default": "webp"
    },
    "file_name": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 255
        },
        {
          "type": "null"
        }
      ],
      "title": "File Name",
      "description": "Optional account-relative storage path for the image. When n is greater than 1, an index is inserted before the extension (for example art/fox.webp becomes art/fox-1.webp and art/fox-2.webp). If omitted, the file is stored under image-generation/ with a generated name."
    }
  },
  "type": "object",
  "required": [
    "prompt"
  ]
}