CleanVector

Generate professional, editable SVG artwork from a text prompt: illustrations, icons, stickers and mascot scenes. The result is real vector paths with a transparent background, not an embedded bitmap. Returns a task that processes asynchronously, so call wait_for_task with the returned id to get the result. Pass mascot_id (from list_mascots) to keep a consistent character across scenes. Costs 4 credits.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 3,
      "maxLength": 2000,
      "description": "What to draw, in plain language"
    },
    "mascot_id": {
      "type": "string",
      "description": "Optional mascot id; the character appears consistently in the scene"
    },
    "no_background": {
      "type": "boolean",
      "default": true,
      "description": "Return only the subject on a transparent background"
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "auto",
        "square",
        "landscape",
        "portrait"
      ],
      "default": "auto"
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Generate a professional vector logo as editable SVG, delivered as a brand kit: the original mark, black and white variants, transparent PNG exports and a color palette measured from the finished artwork. An optional reference can refine an existing identity or provide loose inspiration. Runs asynchronously, so call wait_for_task with the returned id, then download_logo_kit. Costs 8 credits.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 3,
      "maxLength": 2000,
      "description": "Creative brief for the logo"
    },
    "brand_name": {
      "type": "string",
      "maxLength": 80,
      "description": "Exact optional brand name; omit for symbol-only"
    },
    "reference_image_url": {
      "type": "string",
      "format": "uri"
    },
    "reference_image_base64": {
      "type": "string"
    },
    "reference_role": {
      "type": "string",
      "enum": [
        "refine",
        "inspiration"
      ]
    },
    "request_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Convert a raster image (PNG/JPG/WebP, max 5 MB) into a clean, editable SVG. Provide image_url or image_base64. no_background defaults to true and isolates the subject (4 credits). Set no_background false with mode 'direct' to trace as-is (1 credit); mode 'enhance' redraws with AI first (4 credits). Runs async, so poll with wait_for_task.

{
  "type": "object",
  "properties": {
    "image_url": {
      "type": "string",
      "format": "uri",
      "description": "Public URL of the image"
    },
    "image_base64": {
      "type": "string",
      "description": "Base64 image data (raw or data URL)"
    },
    "mode": {
      "type": "string",
      "enum": [
        "direct",
        "enhance"
      ],
      "default": "direct"
    },
    "prompt": {
      "type": "string",
      "maxLength": 2000,
      "description": "Optional guidance for enhance mode"
    },
    "no_background": {
      "type": "boolean",
      "default": true,
      "description": "Isolate the subject on a transparent background"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch the current status of a task. Status is one of queued, processing, succeeded, failed. A succeeded task includes the result with download URLs.

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string",
      "description": "Task id from generate_illustration or vectorize_image"
    }
  },
  "required": [
    "task_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Block until a task settles (succeeded/failed) or the timeout passes. Preferred over polling get_task in a loop. Generation typically takes 10-60 seconds.

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string"
    },
    "timeout_seconds": {
      "type": "integer",
      "minimum": 5,
      "maximum": 50,
      "default": 45
    }
  },
  "required": [
    "task_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the user's most recent tasks, newest first.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the user's ready-to-use mascots (consistent characters). Pass a mascot id to generate_illustration to place that character in a new scene. Mascots are created in the CleanVector dashboard.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return the finished artwork as a PNG image (free on all plans). Use after a task succeeded. For larger exports up to 8192px, use the png_url from the task result with the same Bearer key.

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string"
    },
    "width": {
      "type": "integer",
      "minimum": 16,
      "maximum": 2048,
      "default": 1024,
      "description": "Output width in px (height keeps aspect)"
    },
    "variant": {
      "type": "string",
      "enum": [
        "original",
        "black",
        "white"
      ],
      "description": "Logo only: original/black/white. Artwork tasks have one SVG."
    }
  },
  "required": [
    "task_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return the finished artwork as SVG markup. Use after a task succeeded.

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string"
    },
    "variant": {
      "type": "string",
      "enum": [
        "original",
        "black",
        "white"
      ]
    }
  },
  "required": [
    "task_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return a completed logo kit as an embedded ZIP resource. Includes three SVGs, three PNGs and palette.json. MCP output is capped at 2048px; use zip_url from the task result for larger files.

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string"
    },
    "width": {
      "type": "integer",
      "minimum": 16,
      "maximum": 2048,
      "default": 2048
    }
  },
  "required": [
    "task_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Current plan and credit balance. Costs: vectorize 1, generate/enhance 4, logo 8 credits. PNG and SVG downloads are free on every plan.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}