Input schema (JSON)
{
"type": "object",
"properties": {
"dpi": {
"type": "integer",
"maximum": 2400,
"minimum": 1,
"description": "Pixels per inch of PNG output; needs a size in pt, mm, cm or in. Default 300."
},
"draw": {
"enum": [
"fill",
"stroke",
"stroke_edges"
],
"type": "string",
"description": "fill: filled shapes; stroke: outline of every shape; stroke_edges: only the borders between shapes, each once (no double cuts). Default from the preset."
},
"mode": {
"enum": [
"live",
"test",
"preview"
],
"type": "string",
"description": "test: free, watermarked result for building an integration. preview: free PNG up to 1 MP without watermark, no vectors; fetch its link with format=svg to buy the vectors for 1 credit. Neither is available for vectorize_url. Default live."
},
"unit": {
"enum": [
"px",
"pt",
"mm",
"cm",
"in"
],
"type": "string",
"description": "Unit for width/height: px (default), pt, mm, cm, in."
},
"image": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"download_url": {
"type": "string"
}
},
"description": "Image file attached to the user's message in the chat (ChatGPT)."
},
"scale": {
"type": "number",
"maximum": 100,
"description": "Output size as a multiple of the source size. Not with width/height.",
"exclusiveMinimum": 0
},
"width": {
"type": "number",
"description": "Physical output width in unit. With width only, the height follows the aspect ratio; with height too, a sheet of that size (see aspect). Up to 10 m.",
"exclusiveMinimum": 0
},
"aspect": {
"enum": [
"fit",
"fill",
"stretch"
],
"type": "string",
"description": "With both width and height: fit (default, whole drawing inside), fill (covers the sheet, excess cropped), stretch (exact size, distorted)."
},
"colors": {
"anyOf": [
{
"enum": [
"auto",
"unlimited"
],
"type": "string"
},
{
"type": "integer",
"maximum": 32,
"minimum": 2
}
],
"description": "Number of colors: 'auto', 'unlimited', or an integer 2–32 (max_colors goes up to 256). Default auto."
},
"curves": {
"enum": [
"all",
"lines",
"lines_arcs"
],
"type": "string",
"description": "all: curves and lines; lines: straight segments only; lines_arcs: DXF lines and arcs, other formats as lines."
},
"detail": {
"enum": [
"auto",
"low",
"medium",
"high"
],
"type": "string",
"description": "Output detail for photos. Default auto."
},
"format": {
"type": "array",
"items": {
"enum": [
"svg",
"pdf",
"eps",
"dxf",
"png"
],
"type": "string"
},
"minItems": 1,
"description": "Output formats; several formats cost 1 credit together. Default: the preset's format (svg for web).",
"uniqueItems": true
},
"height": {
"type": "number",
"description": "Physical output height in unit (width follows the aspect ratio unless width is set too).",
"exclusiveMinimum": 0
},
"layers": {
"enum": [
"stacked",
"cutouts",
"cutouts_grouped"
],
"type": "string",
"description": "Shapes stacked on top of each other, cut out of each other, or cut out and grouped by color. Default from the preset."
},
"preset": {
"enum": [
"web",
"print",
"cut",
"laser",
"embroidery"
],
"type": "string",
"description": "Settings for the job: web (default), print (PDF, shapes cut out), cut (vinyl/stickers, 8 colors), laser (2-color outlines), embroidery (12 colors, no tiny shapes)."
},
"align_x": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Horizontal placement on the sheet, 0 left … 1 right (default 0.5). Needs width and height; not with aspect=stretch."
},
"align_y": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Vertical placement on the sheet, 0 top … 1 bottom (default 0.5). Needs width and height; not with aspect=stretch."
},
"corners": {
"enum": [
"sharp",
"smooth"
],
"type": "string",
"description": "Keep corners sharp or round them."
},
"denoise": {
"type": "integer",
"maximum": 3,
"minimum": 0,
"description": "Noise reduction before tracing: 0 off … 3 strongest."
},
"palette": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$"
},
"maxItems": 256,
"minItems": 2
},
{
"type": "string"
}
],
"description": "Fixed colors #rrggbb (2–256), as a list or a comma-separated string. Not combined with colors or max_colors."
},
"quality": {
"enum": [
"auto",
"high",
"medium",
"low"
],
"type": "string",
"description": "Input quality: low for blurry/noisy/JPEG-heavy images. Default auto."
},
"group_by": {
"enum": [
"none",
"color",
"layer"
],
"type": "string",
"description": "Groups in the output: color (one per color) or layer (by nesting depth). SVG <g>, PDF layers, EPS blocks, DXF layers. Default: by color only for layers=cutouts_grouped (DXF always by color)."
},
"min_area": {
"type": "integer",
"maximum": 10000,
"minimum": 0,
"description": "Smallest shape kept, in px²; smaller specks are dropped. Overrides the preset."
},
"upload_id": {
"type": "string",
"description": "ID returned by create_upload after the file was uploaded."
},
"dxf_curves": {
"enum": [
"lines",
"arcs",
"splines"
],
"type": "string",
"description": "DXF curves as lines (polylines, default), arcs or splines. curves=lines/lines_arcs wins."
},
"gap_filler": {
"enum": [
"on",
"off"
],
"type": "string",
"description": "on: an underlay in the shape colors hides light gaps between shapes. Needs draw=fill. Default off."
},
"image_type": {
"enum": [
"auto",
"artwork",
"artwork_sharp",
"photo"
],
"type": "string",
"description": "Kind of image: artwork with smooth (anti-aliased) edges, artwork with hard pixel edges, or photo. Default auto."
},
"max_colors": {
"type": "integer",
"maximum": 256,
"minimum": 2,
"description": "Maximum number of colors (2–256). Not combined with colors or palette."
},
"max_pixels": {
"type": "integer",
"maximum": 4200000,
"minimum": 10000,
"description": "Downscale the input to at most this many pixels before tracing (faster, fewer nodes)."
},
"smoothness": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Contour smoothing 1–10 (higher: smoother, fewer nodes)."
},
"svg_version": {
"enum": [
"1.1",
"1.0",
"tiny1.2"
],
"type": "string",
"description": "SVG flavor: 1.1 (default), 1.0, or tiny1.2 (no opacity or gradient transforms)."
},
"adobe_compat": {
"type": "boolean",
"description": "true: SVG friendly to Adobe Illustrator (size always set, stroke widths in drawing coordinates)."
},
"image_base64": {
"type": "string",
"description": "Exact PNG/JPEG/WebP/BMP/GIF/TIFF file bytes in base64 (≤2 MB), only when you already have them as text (e.g. from reading the file in a terminal). Never transcribe an image you only see in the conversation; call open_editor instead. Use create_upload for larger files."
},
"stroke_color": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$",
"description": "Stroke color #rrggbb instead of the shape color; needs draw=stroke or stroke_edges."
},
"stroke_width": {
"type": "number",
"maximum": 100,
"minimum": 0.01,
"description": "Stroke width; needs draw=stroke or stroke_edges. Output units, or source pixels with stroke_scaling=scale. Default: hairline."
},
"transparency": {
"type": "string",
"pattern": "^(keep|white|#[0-9a-fA-F]{6})$",
"description": "Transparent areas: keep (stay transparent), white, or a background color #rrggbb."
},
"png_antialias": {
"enum": [
"on",
"off"
],
"type": "string",
"description": "Anti-aliasing in PNG output. Default on."
},
"retention_days": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Keep the result downloadable for this many days (default 24 hours). Live mode only."
},
"stroke_scaling": {
"enum": [
"fixed",
"scale"
],
"type": "string",
"description": "fixed (default): width stays in output units when resized; scale: width in source pixels scales with the drawing."
},
"svg_fixed_size": {
"type": "boolean",
"description": "true (default): width/height on the root <svg>; false: only a viewBox (responsive)."
},
"curve_tolerance": {
"type": "number",
"maximum": 10,
"minimum": 0.01,
"description": "Curve fitting tolerance in source pixels (default ≈0.5): lower keeps more nodes. Also sets smoothness unless given."
},
"gap_filler_width": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "Gap filler width in source pixels (default 1). Needs gap_filler=on."
},
"palette_tolerance": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "With palette: how far (CIE76 ΔE) an image color may be from a palette color to snap to it; farther colors keep their own value."
}
},
"additionalProperties": false
}