Skip to content
Get API Access
Get API Access

Ideogram Vector

Early Access

Launches October 22 at noon EST.

Beautiful designs,
editable as SVG.

Create logos and illustrations as fully editable SVGs. Start with a prompt or an existing image, then make every detail your own.

Start with a prompt

Text to vector

Describe the design you have in mind. Ideogram Vector turns your words into editable SVGs, ready to refine.

Example prompt

“A playful wordmark with rounded, bouncy lettering in electric blue and coral orange. A fresh mint-green petal detail adds movement against a warm off-white background.”

Example prompt

“A heart-shaped logo made entirely from soft green lettering on a black background. Bold, rounded letters curve to fill the heart, with an organic, handmade feel.”

Start with an image

Image to vector

Turn an existing image into an editable SVG in 5 seconds or less. Compare the source image with its converted vector, ready to scale and refine.

Original raster image of a koi curved across navy serif lettering with gold accents
The koi and lettering design converted to SVG Hover a shape to highlight its outline. With the image focused, use the arrow keys to inspect shapes.
Source imageSVG
Source image → Converted SVGDrag to compare · Hover SVG to explore

Ideogram Vector API

Pricing

Generate SVG

Price per SVG (USD)
Quality Prompt only With reference images
Low $0.13 $0.13
Medium $0.16 $0.16
High $0.20 $0.32

Image to SVG

Price per image (USD)

$0.10 / image

Convert an existing image directly, without a prompt.

Ideogram Vector

Get early access to Ideogram Vector.

Bring your next idea into editable SVG.

Generate SVG

Expand
curl --fail-with-body \
  "https://api.ideogram.ai/v2/svg/generate/ideogram-vector-1" \
  -H "Api-Key: $IDEOGRAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A playful cat logo with bold outlines and flat colors",
    "quality": "medium",
    "num_images": 1,
    "aspect_ratio": "1x1"
  }'

Image to SVG

Expand
curl --fail-with-body \
  "https://api.ideogram.ai/v2/svg/vectorize/ideogram-vector-1" \
  -H "Api-Key: $IDEOGRAM_API_KEY" \
  -F "image=@input.png" \
  -F "mode=default"
Get API Access

For early-access partners

Ideogram Vector API

Create SVGs from a prompt or convert an existing image. Submit, poll, and download.

Partner access

Your account must be enabled by Ideogram for these early-access endpoints. Contact your Ideogram representative to enable the flows you need. Get your API key, then set IDEOGRAM_API_KEY below. Authenticate with the Api-Key header at https://api.ideogram.ai.

Shell setup
export IDEOGRAM_API_KEY="<your-api-key>"

Generate SVG

Describe your design in a prompt. Image references are optional.

POST /v2/svg/generate/ideogram-vector-1

cURL
curl --fail-with-body \
  "https://api.ideogram.ai/v2/svg/generate/ideogram-vector-1" \
  -H "Api-Key: $IDEOGRAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A playful cat logo with bold outlines and flat colors",
    "quality": "medium",
    "num_images": 1,
    "aspect_ratio": "1x1"
  }'

Accepted response: {"generation_id":"<generation-id>"}. Use that ID to poll for results below.

Parameter Description
prompt Required. A text description, up to 9,500 characters.
quality
Optional. Accepted values:
  • low — Faster generation.
  • medium — Balanced speed and quality. Used if omitted.
  • high — Highest quality.
num_images Optional. Number of SVGs, from 1 to 8. Defaults to 1.
aspect_ratio
Optional. Accepted values (width × height):
  • auto — Automatic aspect ratio. Used if omitted.
  • 1x1 — Square.
  • 1x4 , 1x3 , 1x2 , 9x16 , 10x16 , 2x3 , 3x4 , 4x5 — Portrait.
  • 5x4 , 4x3 , 3x2 , 16x10 , 16x9 , 2x1 , 3x1 , 4x1 — Landscape.
seed Optional. An integer from 0 to 2147483647 for reproducible generation.
images Optional. Up to 5 multipart image files. The first image is the primary source; the others are additional references.
image_asset_identifiers Optional. Up to 5 existing asset identifiers, each with asset_type and asset_id. Takes priority over images when both are provided.

Convert an image to SVG

Upload an existing image to convert it directly, without a prompt.

POST /v2/svg/vectorize/ideogram-vector-1

cURL
curl --fail-with-body \
  "https://api.ideogram.ai/v2/svg/vectorize/ideogram-vector-1" \
  -H "Api-Key: $IDEOGRAM_API_KEY" \
  -F "image=@input.png" \
  -F "mode=default"

Accepted response: {"generation_id":"<generation-id>"}. Use that ID to poll for results below.

Parameter Description
image Source image as a multipart file. JPEG, PNG, or WebP, up to 50 MB.
image_asset_identifier An existing asset instead of an image upload. Send an object with asset_type and asset_id. For example: {"asset_type": "RESPONSE", "asset_id": "<asset-id>"}. Use application/json for the request, or an application/json part in multipart.
mode
Optional. Accepted values:
  • simple — Fewer, simpler shapes.
  • default — Preserves finer details. Used if omitted.

Poll and download your SVGs

GET /v1/generations/{generation_id}

After either submission, poll with the same API key. While status is pending, wait before polling again. Stop on failed. When it is completed, download each signed data[].url. Each result is an SVG with MIME type image/svg+xml.

cURL
# Replace <generation-id> with the ID from your submission.
curl --fail-with-body \
  "https://api.ideogram.ai/v1/generations/<generation-id>" \
  -H "Api-Key: $IDEOGRAM_API_KEY"

# Repeat the GET while status is "pending". Stop if it is "failed".
# Once status is "completed", copy a URL from data[].url.
curl --fail --location "<signed-svg-url>" --output vector.svg

If a request is still pending, poll again with the same ID rather than submitting another request. Download each returned URL if you requested multiple SVGs.

Example completed response · placeholder values
{
  "generation_id": "<generation-id>",
  "status": "completed",
  "created": "2026-10-19T12:00:00Z",
  "response_type": "url",
  "data": [
    {
      "object_type": "svg.generation",
      "asset_id": "<asset-id>",
      "url": "<signed-svg-url>",
      "mime_type": "image/svg+xml",
      "width": 1024,
      "height": 1024
    }
  ]
}
Access errors: A 401 indicates an authentication problem. A 403 means your account is not authorized for the operation; contact your Ideogram representative.
Ideogram Vector · API docs
Hover a shape to highlight its outline. With the artwork focused, use the arrow keys to inspect shapes.