GenerateImageRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/ffmpeg-micro-com/json-schema/ffmpeg-micro-com-generate-image-request-schema.json",
  "title": "GenerateImageRequest",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/ffmpeg-micro-com-openapi.yaml#/components/schemas/GenerateImageRequest",
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "maxLength": 2000
    },
    "aspect": {
      "type": "string",
      "enum": [
        "landscape_16_9",
        "portrait_9_16",
        "square_1_1"
      ],
      "default": "landscape_16_9"
    },
    "model": {
      "type": "string",
      "enum": [
        "flux-schnell",
        "nano-banana"
      ],
      "default": "flux-schnell",
      "description": "Ignored when `reference_urls` is given (references force `nano-banana`)"
    },
    "reference_urls": {
      "type": "array",
      "minItems": 1,
      "maxItems": 4,
      "items": {
        "type": "string",
        "format": "uri"
      },
      "description": "https images the result must stay faithful to (a character sheet, a product shot)"
    },
    "seed": {
      "type": "integer",
      "minimum": 0,
      "description": "Fixed seed for repeatability. Omit for random; `null` is rejected."
    }
  }
}