aspectRatioenum
Aspect ratio for the edited SVG: auto (maintain original proportions), square (1:1, good for logos), portrait (taller, good for posters), landscape (wider, good for banners). Do not specifiy if not explicitely mentioned by the user. When not specified the quality will determine the default (low and medium use auto, high forces square aspect ratio)
backgroundenum
Background style for the edited SVG: auto (AI determines best, default), transparent (no background, preserves transparency), opaque (solid background color). Do not specify if not explicitly mentioned by the user.
color_modeenum
Color scheme: full_color (default, wide palette), monochrome (single color/shades), few_colors (limited palette). Only specify if user requests a specific color scheme.
compositionenum
Layout composition: centered_object (single focus element), repeating_pattern (tiled/repeated), full_scene (complete scene), objects_in_grid (grid arrangement). Only specify if user requests a specific layout.
generation_idstring
Deprecated alias for input, restricted to an SVGMaker generation or gallery id. Prefer input.
image_complexityenum
Complexity level: icon (simple, minimal detail), illustration (moderate detail), scene (complex, full composition). Only specify if user requests a specific complexity.
inputstring
Image source. Accepts a local absolute file path, an https:// URL, an upl_ upload id, or an SVGMaker generation id (your own generations or public gallery items).
input_pathstring
Deprecated alias for input, restricted to a local absolute file path. Prefer input.
output_pathstring
Optional absolute file path to save the result locally. Use the .svg extension, or .png when raster is true. Example: "/Users/username/Documents/modified-artwork.svg". Omit it to get a hosted SVGMaker URL instead of a file.
promptstringобязательный
Detailed instructions for how to modify the image. Be specific about changes like style adjustments, color modifications, element additions/removals, or layout changes. Example: "Change the background to blue and add a white border"
qualityenum
Quality level for SVG editing. Do not specifiy if not explicitely mentioned by the user. Affects processing time and detail level: low (fast, basic edits), medium (balanced quality and speed, default), high (best quality, forces square aspect ratio)
rasterboolean
When true, skips SVG vectorization and returns a raster PNG image instead of SVG. The output_path should use .png extension. Useful when the user wants a quick raster image without vectorization. Cannot be used with storage.
storageboolean
When true, stores the edited image permanently in cloud storage. Cannot be used with raster mode. Defaults to true when raster is not set.
styleenum
Art style for the SVG: flat (clean minimal), line_art (outline-based), engraving (detailed etched), linocut (block print), silhouette (solid shapes), isometric (3D-like), cartoon (playful), ghibli (anime-inspired). Only specify if user requests a specific style.
text_styleenum
Text handling in SVG: only_title (just a title/heading), embedded_text (text integrated into the design). Only specify if the design should include text.
