SvgGenerateRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/amnt-io/json-schema/amnt-io-svg-generate-request-schema.json",
  "title": "SvgGenerateRequest",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amnt-io-openapi.json#/components/schemas/SvgGenerateRequest",
  "allOf": [
    {
      "$ref": "#/$defs/SvgOptions"
    },
    {
      "type": "object",
      "required": [
        "prompt"
      ],
      "properties": {
        "prompt": {
          "type": "string",
          "minLength": 3,
          "maxLength": 2000
        },
        "style": {
          "type": "string",
          "enum": [
            "auto",
            "flat",
            "icon",
            "logo",
            "illustration",
            "pixel"
          ],
          "default": "auto"
        },
        "aspect": {
          "type": "string",
          "default": "1:1",
          "description": "\"auto\", a preset (1:1, 4:5, 3:4, 2:3, 9:16, 1:2, 5:4, 4:3, 3:2, 16:9, 2:1) or any W:H up to 3:1. Same price in every shape."
        }
      }
    }
  ],
  "$defs": {
    "SvgOptions": {
      "type": "object",
      "properties": {
        "detail": {
          "type": "string",
          "enum": [
            "low",
            "medium",
            "high"
          ],
          "default": "medium",
          "description": "low = bold and simple, medium = clean, high = closest to the picture."
        },
        "background": {
          "type": "string",
          "enum": [
            "transparent",
            "keep"
          ],
          "description": "Default transparent for generate, keep for vectorize."
        },
        "mode": {
          "type": "string",
          "enum": [
            "stacked",
            "cutout"
          ],
          "default": "stacked",
          "description": "cutout = no overlapping shapes (Figma, cutting machines)."
        },
        "colors": {
          "type": "integer",
          "minimum": 2,
          "maximum": 64
        },
        "palette": {
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^#[0-9a-fA-F]{6}$"
          },
          "description": "Snap every colour to these."
        },
        "layers": {
          "type": "string",
          "enum": [
            "color",
            "objects"
          ],
          "default": "color",
          "description": "objects = each thing as its own named, movable group."
        },
        "objects": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 4
        },
        "formats": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "svg",
              "png",
              "pdf",
              "eps",
              "dxf",
              "icons",
              "small",
              "webp",
              "jpg"
            ]
          }
        },
        "png_width": {
          "type": "integer",
          "minimum": 16,
          "maximum": 8192
        },
        "model": {
          "type": "string",
          "enum": [
            "amnt-auto",
            "amnt-svg-lite-1.1",
            "amnt-svg-1.1",
            "amnt-svg-pro-1.1",
            "amnt-trace-1.2",
            "amnt-vectorize-1.1"
          ],
          "description": "The AMNT model. Leave it out for AMNT Draw 1.2, the default. Old ids (amnt-svg-auto, amnt-svg-1 …) still work. amnt-auto AMNT Auto ($0.01-$0.25, picks per request) · amnt-svg-lite-1.1 AMNT SVG Lite 1.1 ($0.01: simple icons, charts, patterns) · amnt-svg-1.1 AMNT SVG 1.1 ($0.03: icons, logos, lettering) · amnt-svg-pro-1.1 AMNT SVG Pro 1.1 ($0.25: characters, detailed art) · amnt-trace-1.2 AMNT Trace 1.2 ($0.05: pixel art, scenes, illustrations) · amnt-vectorize-1.1 AMNT Vectorize 1.1 (vectorize only: $0.08 a logo or icon as clean code, else $0.01)."
        }
      }
    }
  }
}