Real vector designs vs raster images
Sivi API delivers editable vector outputs, unlike raster images that pixelate and limit scaling flexibility.
Any dimension vs limited aspect ratios
Sivi API generates designs in custom sizes, avoiding the restrictions of fixed aspect ratio templates.
Automated design generation vs drag-and-drop editing
Sivi API automates design generation programmatically, avoiding manual drag-and-drop steps that slow development workflows.
Brand consistency across designs vs repeated asset setup
Sivi applies brand rules automatically in just a one-time setup, unlike templated tools requiring asset re-uploads for every new design.
Multi-language support vs manual conversion
Sivi API supports 72+ languages, eliminating the need for tedious manual translation and design adaptation.
What makes this different
Layered, editable output
The API returns a structured design file, not a raster image. Every element (text blocks, images, vectors, backgrounds) exists on its own layer with independent coordinates, styles, and properties. You can programmatically access, modify, or remove any element after generation.
Text rendering
The API returns a structured design file, not a raster image. Every element (text blocks, images, vectors, backgrounds) exists on its own layer with independent coordinates, styles, and properties. You can programmatically access, modify, or remove any element after generation.
Layout composition engine
The LDM does not stretch, crop, or scale. It re-composes the entire layout for each target dimension. A 728x90 leaderboard and a 1080x1080 social post get different visual hierarchies, not different zoom levels of the same layout.
Brand system
Attach a brand kit to your API key: hex codes, font families, logo files, spacing rules. The model enforces these as hard constraints on every generation. No per-request configuration needed. No drift across thousands of outputs.
Async generation
POST your request and get a designId back immediately. Poll for completion or register a webhook. The API handles queuing, processing, and delivery. Concurrent requests supported on all plans.
Export pipeline
Each generated design can be exported as JPG, PNG, HTML, or PDF. The export endpoint accepts the designId and returns rendered output in your specified format.
Sivi API request lifecycle
Phase 1: Request
POST a JSON payload to designs-from-prompt with a natural language prompt, or to designs-from-content with structured data (headline, body, CTA, product URL). Include your brand kit ID, target dimension, language, and numOfVariants.
Phase 2: Generation
The API queues your request and returns a designId immediately. The LDM resolves brand assets, selects layout patterns, and composes a multi-layered design. Typical generation time: under 60 seconds. Use polling or webhook callbacks to detect completion.
Phase 3: Retrieval
Call get-design-variants with your designId. Each variant includes a variantImageUrl (rendered preview), a variantEditLink (anonymous design studio for editing), and layer metadata. Export endpoints return JPG, PNG, HTML, or PDF.
Code samples
Generate a design (cURL)
Generate a design (Python)
Generate a design (Node.js)
What the output looks like
Other APIs return flat images. The Sivi API returns structured design files.
API key (sivi-api-key header)
Integration options
Platform teams integrate the Sivi API to give their users design superpowers without building design infrastructure from scratch. Here is how different product categories use it.
REST API (headless)
Call designs-from-prompt or designs-from-content, poll get-design-variants for results, and serve the output however you want. No frontend dependency. Best for automated pipelines, batch generation, and server-side processing.
SDK (full design studio)
Import the React component or embed via iframe. The SDK handles generation, editing, and export in your frontend. You control theming, permissions, and user routing.
MCP server (AI agents)
Install the MCP server. Any MCP-compatible client such as Claude, ChatGPT, Cursor, Windsurf calls Sivi as a tool within conversations or automated workflows. No custom integration code.
Hybrid
Use the API for automated, high-volume generation, the SDK for interactive user-facing design, and the MCP server for AI agent workflows. Many integrators use more than one.
How businesses use Sivi API
Platform teams integrate the Sivi API to give their users design superpowers without building design infrastructure from scratch. Here is how different product categories use it.
Sivi design API for digital and email marketing platforms
Increase your email marketing platform's capabilities with Sivi's design API integration. Your users can create branded headers, newsletter graphics, and campaign visuals right inside your platform. No more switching between tools or getting stuck on visual designs.
Sivi design API for media and content creation companies
Let Sivi handle design while you focus on content. Create marketing visuals in multiple languages that grow with your content needs and keep your brand looking consistent everywhere.
Sivi design API for eCommerce platforms
Give your sellers instant design power by integrating the Sivi design API in your ecommerce platform. Sellers can design product banners, category headers, and promotional graphics without any design skills. Keep sellers happy and get their marketing materials done fast.
Sivi design API for LLM, Large Language Models
When your LLM writes marketing copy, Sivi can generate matching visuals. Give your users a complete marketing package with words and designs that work together perfectly.
Sivi design API for social media platforms
Integrating Sivi design API to social media platforms helps users create branded posts and stories without jumping to other apps, which means better engagement and happier users.
Sivi design API for ad platforms and media aggregators
Stop losing users during the creative process. Integrate the Sivi design API to generate ad creative visuals instantly that match your users' goals and brand perfectly.
Sivi design API for website builders
Enhance your website-building capabilities by connecting to the Sivi design API. Users get to create website hero banners, website headers, and promotional graphics that automatically adapt to their brand and content needs.
Sivi design API for agencies
Offer clients a branded creative portal powered by the SDK. Each client gets their own brand kit, self-serve access, and your agency keeps creative control.
Common questions about the design API
How does authentication work?
Every request requires a sivi-api-key header. Create your key at instant.sivi.ai and make your first call. The quickstart guide walks you through generating your first design in under 5 minutes.
Is the Sivi API a template-based system?
No. The API uses the Large Design Model (LDM) and generates original layouts on every call. Send the same prompt twice and get two different, well-composed designs. No template library to build or maintain. Your content and brand kit are the only inputs the model needs.
How is this different from image generation APIs like Nano Banana or Midjourney?
Image generation APIs produce flat raster images with no editable layers and often hallucinate text. The Sivi design API generates structured, multi-layered designs where every text block is real editable text and every element is a separate layer. You get a graphic design API output you can work with, not a frozen image.
How do I handle async generation?
POST your request and receive a designId immediately. Poll the get-design-variants endpoint or register a webhook to be notified on completion. Concurrent requests are supported on all plans.
What user management models does the API support?
The API supports three user management models:
User redirection: End-users are redirected to create Sivi accounts directly.
API-managed users: Create and manage end-user accounts programmatically with your API key.
Fully embedded: Users access design generation without leaving your platform. No Sivi-branded touchpoints.
How is data secured during API interactions?
API keys authenticate every request. All data is encrypted in transit and at rest. Brand assets and generated designs are isolated per account and not used for model training. Enterprise plans include custom data residency options.
How is Sivi API different from Canva API?
Sivi API auto-generates designs from prompts, no templates involved. Canva API provides access to a template-based editor for manual, collaborative design. Sivi is generative infrastructure. Canva is a collaborative editing tool. Full comparison
What enterprise API integration features are available?
Enterprise integration includes:
Custom themes and white-labeling options for SDK
Flexible deployment options and staging environments
Dedicated support and custom feature development
Influence on product roadmap
Is there a sandbox for testing?
Yes. The sandbox costs $1 one-time and gives you 20 credits with 7-day validity. Test output quality, integration patterns, and response formats before committing to a paid plan.
Do I own the designs generated through the API?
Yes. All designs generated with your API key are your intellectual property. Sivi does not claim any rights over your generated output or brand assets.
Start building with Sivi API
Get API access and start integrating automated design generation into your application.































