Skip to main content

AI-powered icon generation

Generate custom icons from text descriptions using advanced AI models, with support for multiple styles and vector output formats.
AI Icon Generation is a text-to-icon API that creates custom icons from natural language prompts. Describe the icon you need, and receive production-ready PNG or SVG files in your chosen style. The API supports 5 distinct visual styles and offers a preview workflow for rapid iteration before final rendering.

​
Key capabilities

  • Text-to-icon generation: Create icons from natural language descriptions (e.g., “A cute cat icon”, “Shopping cart with heart”)
  • Multiple output formats: Export as PNG for raster graphics or SVG for scalable vector graphics
  • 5 visual styles: Choose from solid, outline, color, flat, or sticker styles
  • Preview workflow: Generate quick previews before committing to final high-quality renders
  • Quality tuning: Adjust num_inference_steps (10-50) and guidance_scale (0-10) for fine control
  • Async processing: Webhook notifications for task completion
  • Vector-ready output: SVG format for infinite scalability without quality loss

​
Use cases

  • Mobile app development: Generate consistent icon sets for iOS and Android applications
  • Web design: Create custom icons matching your brand identity and design system
  • UI/UX prototyping: Rapidly iterate on icon concepts during design exploration
  • Marketing materials: Generate unique icons for presentations, infographics, and social media
  • Brand identity: Create distinctive iconography that aligns with brand guidelines
  • E-commerce: Generate product category icons, feature badges, and navigation elements

​
Generate icons with the API

Create icons by submitting a text prompt with your desired style and format. Use the preview endpoint for quick iterations, then render the final output in your preferred format.

POST /v1/ai/text-to-icon

Generate a new icon from text prompt

POST /v1/ai/text-to-icon/preview

Generate a quick preview of the icon

POST /v1/ai/text-to-icon/{task-id}/render/{format}

Download icon in PNG or SVG format

​
Parameters

ParameterTypeRequiredDefaultDescription
promptstringYes-Text description of the icon to generate (e.g., “A cute cat icon”)
webhook_urlstringYes-URL for task completion notification
stylestringNosolidVisual style: solid, outline, color, flat, or sticker
formatstringNopngOutput format: png or svg
num_inference_stepsintegerNo10Generation quality steps (10-50, higher = better quality, slower)
guidance_scalenumberNo7Prompt adherence strength (0-10, higher = stricter prompt following)

​
Style reference

StyleDescriptionBest for
solidFilled shapes with single colorUI icons, navigation elements
outlineLine-based icons with strokesMinimalist designs, light themes
colorMulti-colored filled iconsMarketing, illustrations
flatSimplified shapes with flat colorsModern app interfaces
stickerDecorative style with playful lookSocial media, casual apps

​
Frequently Asked Questions

AI Icon Generation is a text-to-icon API that uses advanced AI models to create custom icons from natural language descriptions. You submit a prompt describing the icon you want (e.g., “A shopping cart icon”), choose a style and format, and receive a task ID. Poll for results or receive a webhook notification when the icon is ready. The output is a production-ready PNG or SVG file.
The API supports two output formats: PNG for raster graphics and SVG for scalable vector graphics. PNG is ideal for immediate use in web and mobile applications, while SVG provides infinite scalability without quality loss, perfect for responsive designs and print materials.
Five visual styles are available: solid (filled shapes), outline (line-based), color (multi-colored), flat (simplified modern), and sticker (decorative playful). Each style suits different design contexts - solid and outline work well for UI elements, while color and sticker are better for marketing and casual applications.
Be specific and descriptive. Good examples: “A cute cat icon”, “Shopping cart with a heart”, “Lightning bolt in a circle”, “Envelope with notification badge”. Include the subject and any distinctive features. Avoid overly complex descriptions - icons work best as simple, recognizable symbols.
The preview endpoint (/preview) generates a quick draft for rapid iteration during the design process. The main generate endpoint (/v1/ai/text-to-icon) creates the production-ready icon. Use previews to explore different prompts and styles, then generate the final version once satisfied.
num_inference_steps (10-50) controls generation quality - higher values produce more refined icons but take longer. guidance_scale (0-10) determines how strictly the AI follows your prompt - higher values create icons more closely matching your description, while lower values allow more creative interpretation.
Rate limits vary by subscription tier. See Rate Limits for current limits and quotas.
See the Pricing page for current rates and subscription options.

​
Best practices

  • Prompt clarity: Use clear, concise descriptions focusing on the core concept of the icon
  • Style consistency: Use the same style across icon sets for visual coherence in your application
  • Preview first: Use the preview endpoint to iterate quickly before generating final renders
  • SVG for scalability: Choose SVG format when icons will be used at multiple sizes
  • Quality vs. speed: Start with default num_inference_steps (10) for testing, increase for production
  • Guidance tuning: Use higher guidance_scale (8-10) for literal interpretations, lower (4-6) for creative variations
  • Webhook integration: Use webhooks instead of polling for production applications
  • Error handling: Implement retry logic with exponential backoff for 503 errors