How does the AI SVG generation work?

Our service uses advanced AI image generation technology to create images based on your text prompts, then converts them to SVG format using sophisticated vectorization algorithms. This gives you high-quality, scalable vector graphics that can be used in any design project.

What's the difference between the quality levels?

We offer three quality levels for AI-generated images: Low (1 credit), Medium (2 credits), and High (4 credits). Higher quality settings produce more detailed and refined images with better resolution, which results in cleaner SVG conversions.

Can I upload my own images for conversion?

Yes! You can upload any raster image (JPG, PNG, etc.) and convert it directly to SVG for 1 credit. You can also edit your uploaded image with a text prompt before conversion for 3 credits.

How many free credits do I get?

New users receive 5 free credits upon signup. After that, log in daily to receive 5 credits, which reset at midnight. These credits can be used for any combination of generations, conversions, or edits.

What happens to my generated images?

If you're a free user (haven't purchased additional credits), your generations will be public and may appear in our community gallery. Once you purchase credits, new generations become private by default.

Are refunds available?

No, all credit purchases are final and non-refundable. Please make sure to review our credit system and pricing before making a purchase.

What are the file size limits?

For direct image uploads, the maximum file size is 100MB. For image editing, the maximum file size is 25MB due to API limitations.

Can I use the generated SVGs commercially?

Commercial use is only available for paid customers who have purchased credits. Free users can use generated SVGs for personal projects only. Once you purchase credits, you gain commercial use rights for all your generations.

What is SVGMaker MCP Server?

SVGMaker MCP Server is an AI-powered asset generation tool that integrates directly with your code editor (Cursor or VS Code). It automatically detects when you need icons, illustrations, or graphics in your project and generates them on-the-fly, matching your website's style. Detailed documentation and setup instructions are available in our docs section to help you get started.

Is there an API available for developers?

Yes, we provide an API that allows developers to integrate our SVG generation capabilities into their applications or workflows. This is ideal for automating graphic creation or enhancing user experiences within your platform.

Public API Reference

Comprehensive API documentation for SVGMaker. Learn how to generate, edit, and convert SVGs using our public API.

Getting Started

Start building with SVGMaker API in minutes

Generate SVGs

Create stunning vector graphics from text descriptions using advanced AI

Edit Images

Transform existing images and SVGs with AI-powered modifications

Convert to SVG

Convert raster images (PNG, JPEG) to scalable vector format

Base URL

https://svgmaker.io/api

All API endpoints are relative to this base URL

Quick Start Guide

Get Your API Key

Get API Key

Make Your First Request

Generate your first SVG with a simple API call

Terminal

curl -X POST https://svgmaker.io/api/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: svgmaker-io{your-api-key}" \
  -d '{
    "prompt": "A simple geometric logo with blue and white colors",
    "quality": "medium"
  }'

Get Your SVG

Receive a high-quality SVG file ready for use

JSON Response

{
  "svgUrl": "https://storage.googleapis.com/.../generated.svg",
  "creditCost": 2,
  "quality": "medium"
}

You're Ready!

Your first SVG is just an API call away. Explore the endpoints below to unlock the full power of SVGMaker.

Authentication

Secure your API requests with API key authentication

API Key Header

All API endpoints require authentication via an API key passed in the x-api-key header.

x-api-key: svgmaker-io{your-api-key}

Security Best Practices

Keep your API key secure and never share it publicly

Store API keys in environment variables, not in your code

Rotate your API keys regularly for enhanced security

Monitor your API usage to detect any unauthorized access

Credit System

Understand how credits work and choose the right plan for your needs

Credit Pricing

Operation	Quality	Credits	Description
Convert	NA	1 credit	Convert raster images to SVG
Generate	Low	1 credit	Basic quality SVG generation
Generate	Medium	2 credits	Standard quality SVG generation
Generate	High	4 credits	Premium quality SVG generation
Edit	NA	3 credits	AI-powered image/SVG editing

Core API Endpoints

Explore the main API endpoints for generating, editing, and converting SVGs

Generate SVG

Create stunning SVG graphics from text descriptions using advanced AI technology.

Method

POST

Endpoint

/api/generate

Credits

1-4depending on quality

Headers

HTTP Headers

Content-Type: application/json
x-api-key: svgmaker-io{your-api-key}

Request Body

JSON Schema

{
  "prompt": "string",
  "quality": "low|medium|high",
  "aspectRatio": "auto|portrait|landscape|square|wide|tall",
  "background": "auto|transparent|opaque",
  "stream": "boolean",
  "base64Png": "boolean",
  "svgText": "boolean",
  "styleParams": {
    "style": "string",
    "color_mode": "string",
    "image_complexity": "string",
    "category": "string",
    "composition": "string",
    "advanced": {
      "stroke_weight": "thin|medium|thick",
      "corner_style": "none|rounded|sharp",
      "shadow_effect": "none|soft|hard"
    }
  }
}

Example Request

Terminal

curl -X POST https://svgmaker.io/api/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: svgmaker-io{your-api-key}" \
  -d '{
    "prompt": "A minimalist mountain landscape with geometric shapes",
    "quality": "high",
    "aspectRatio": "landscape",
    "background": "transparent",
    "base64Png": true,
    "svgText": true,
    "styleParams": {
      "style": "minimalist",
      "color_mode": "monochrome",
      "composition": "center-object"
    }
  }'

Example Response

JSON Response

{
  "svgUrl": "https://storage.googleapis.com/your-bucket/generated-svg.svg",
  "creditCost": 4,
  "base64Png": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
  "svgText": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 1024 1024\">...</svg>",
  "prompt": "A minimalist mountain landscape with geometric shapes",
  "quality": "high",
  "revisedPrompt": "A minimalist mountain landscape featuring clean geometric mountain shapes..."
}

Edit SVG/Image

Transform existing images and SVGs with AI-powered modifications and enhancements.

Method

POST

Endpoint

/api/edit

Credits

3 credits

Headers

HTTP Headers

Content-Type: multipart/form-data
x-api-key: svgmaker-io{your-api-key}

Request Body (Form Data)

Field	Type	Required	Description
image	File	Yes	Image file to edit (PNG, JPEG, WebP, SVG)
prompt	string	Yes	Edit instructions as a simple text string
styleParams	string	No	JSON string containing style parameters
quality	string	No	Quality level: "low", "medium", "high" (default: "medium")
aspectRatio	string	No	Aspect ratio: "auto", "portrait", "landscape", "square", "wide", "tall" (default: "auto")
background	string	No	Background: "auto", "transparent", "opaque" (default: "auto")
stream	boolean	No	Enable streaming response (default: false)
base64Png	boolean	No	Include base64-encoded PNG preview in response (default: false)
svgText	boolean	No	Include SVG source code as text in response (default: false)

Example Request

Terminal

curl -X POST https://svgmaker.io/api/edit \
  -H "x-api-key: svgmaker-io{your-api-key}" \
  -F "image=@input-image.png" \
  -F "prompt=Add a golden frame around this image" \
  -F "quality=medium" \
  -F "aspectRatio=square" \
  -F "background=transparent" \
  -F "base64Png=true" \
  -F "svgText=true"

Example Response

JSON Response

{
  "svgUrl": "https://storage.googleapis.com/your-bucket/edited-svg.svg",
  "originalImageUrl": "https://storage.googleapis.com/your-bucket/original-image.png",
  "creditCost": 3,
  "base64Png": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
  "svgText": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 1024 1024\">...</svg>",
  "prompt": "Add a golden frame around this image",
  "quality": "medium"
}

Convert Image to SVG

Transform raster images into scalable vector graphics with AI-powered conversion.

Method

POST

Endpoint

/api/convert

Credits

1 credit

Headers

HTTP Headers

Content-Type: multipart/form-data
x-api-key: svgmaker-io{your-api-key}

Request Body (Form Data)

Field	Type	Required	Description
file	File	Yes	Image file to convert (PNG, JPEG, WebP, etc.)
stream	boolean	No	Enable streaming response (default: false)
svgText	boolean	No	Include SVG source code as text in response (default: false)

Example Request

Terminal

curl -X POST https://svgmaker.io/api/convert \
  -H "x-api-key: svgmaker-io{your-api-key}" \
  -F "file=@image-to-convert.png" \
  -F "stream=false" \
  -F "svgText=true"

Example Response

JSON Response

{
  "svgUrl": "https://storage.googleapis.com/bucket-name/converted-svg.svg",
  "originalImageUrl": "https://storage.googleapis.com/bucket-name/original-image.png",
  "creditCost": 1,
  "quality": "medium",
  "svgText": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 1024 1024\">...</svg>"
}

Advanced Features

Unlock powerful capabilities with streaming, custom formats, and style parameters

Streaming Responses

When stream=true is set, responses are sent as Server-Sent Events (SSE) for real-time updates.

Content Type

HTTP Header

Content-Type: text/event-stream

Stream Event Types

Stream Events

{"status": "processing", "message": "Received request..."}
{"status": "processing", "message": "Generating image..."}
{"status": "processing", "message": "Processing SVG paths..."}
{"status": "complete", "svgUrl": "https://...", "simulationMode": false}

Error in Stream

Error Event

{"status": "error", "error": "Error message", "errorType": "general_error"}

Response Format Options

Base64 PNG Output (base64Png)

When base64Png=true is included in requests to /api/generate or /api/edit, the response will include a base64Png field containing a base64-encoded PNG preview of the generated SVG.

JSON Response

{
  "svgUrl": "https://...",
  "base64Png": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
  "creditCost": 2
}

SVG Source Code Output (svgText)

When svgText=true is included in requests to any endpoint, the response will include a svgText field containing the raw SVG source code.

JSON Response

{
  "svgUrl": "https://...",
  "svgText": "<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1024 1024">...</svg>",
  "creditCost": 2
}

SDK Documentation

Integrate SVGMaker into your applications with our official SDKs

Node.js SDK

Installation

Terminal

npm install svgmaker-sdk-node

Basic Usage

JavaScript

import SVGMakerClient from 'svgmaker-sdk-node';

// Initialize the client
const client = new SVGMakerClient('svgmaker-io{your-api-key}');

// Generate an SVG
const result = await client.generate({
  prompt: 'A geometric mountain landscape',
  quality: 'high',
  styleParams: {
    style: 'minimalist',
    color_mode: 'monochrome'
  },
  base64Png: true,
  svgText: true
});

console.log(result.svgUrl);

API Methods

Generate SVG

Create SVGs from text prompts

Edit SVG/Image

Modify existing images

Convert Image to SVG

Convert raster to vector

Configuration Options

JavaScript

const client = new SVGMakerClient('svgmaker-io{your-api-key}', {
  baseUrl: 'https://svgmaker.io/api',
  timeout: 30000,
  retries: 3,
  rateLimit: {
    requestsPerMinute: 60
  }
});

Error Handling

JavaScript

try {
  const result = await client.generate({
    prompt: 'A beautiful landscape'
  });
} catch (error) {
  if (error.code === 'INSUFFICIENT_CREDITS') {
    console.log('You need more credits');
  } else if (error.code === 'RATE_LIMITED') {
    console.log('Rate limit exceeded');
  } else {
    console.log('An error occurred:', error.message);
  }
}

Built-in Security

Automatic API key management

Request validation and sanitization

Secure error handling

Performance Features

Automatic retry logic

Rate limiting protection

Connection pooling

Why Use Our SDK?

Type Safety

Full TypeScript support with comprehensive type definitions

Easy Integration

Simple API that matches your existing code patterns

Active Support

Regular updates and community-driven improvements

Error Handling

Handle errors gracefully with proper status codes and error messages

HTTP Status Codes

Status Code	Description	Action Required
200	Success	Process response normally
400	Bad Request - Invalid parameters	Check request parameters
401	Unauthorized - Invalid or missing API key	Verify API key
402	Payment Required - Insufficient credits	Purchase more credits
413	Payload Too Large - File size exceeds limit	Reduce file size
429	Too Many Requests - Rate limit exceeded	Implement backoff strategy
500	Internal Server Error	Retry later

Common Error Examples

Insufficient Credits

JSON Error

{
  "error": "Insufficient credits",
  "creditsRequired": 4
}

Content Safety Rejection

JSON Error

{
  "error": "Content that is not allowed by our safety system",
  "errorType": "content_safety"
}

File Too Large

JSON Error

{
  "error": "File size exceeds 25 MB limit"
}

Invalid File Format (Convert)

JSON Error

{
  "error": "SVG files are already in vector format and do not need conversion"
}

Error Handling Best Practices

Always check status codes before processing responses

Handle rate limits by implementing exponential backoff

Validate file formats before uploading

Check credit balance before making requests

Implement retry logic for transient errors

Log errors for debugging and monitoring

Support

Get help and resources to make the most of SVGMaker API

Contact Information

Email Support

Get direct help from our technical team

Contact Support

Chat Support

Get instant help from our technical team

Chat Support

Learning Resources

Blog Articles

Learn from our detailed guides and tutorials

Read Blogs

Public API Reference

Table of Contents

Getting Started

Generate SVGs

Edit Images

Convert to SVG

Base URL

Quick Start Guide

Get Your API Key

Make Your First Request

Get Your SVG

You're Ready!

Authentication

API Key Header

Security Best Practices

Credit System

Credit Pricing

Core API Endpoints

Generate SVG

Edit SVG/Image

Convert Image to SVG

Advanced Features

Streaming Responses

Response Format Options

SDK Documentation

Node.js SDK

Built-in Security

Performance Features

Why Use Our SDK?

Error Handling

HTTP Status Codes

Common Error Examples

Error Handling Best Practices

Support

Contact Information

Email Support

Chat Support

Learning Resources

Blog Articles