---
title: "Design API | Sivi API for developers"
description: "Integrate Sivi's design API into your app. Send a prompt, get layered, editable, on-brand designs back. Not templates, not flat images."
url: https://sivi.ai/api
---

# The design API

Integrate AI design generation into your product. Use Sivi's design API to generate multilingual, on-brand marketing designs directly inside your platform. Send a text prompt and brand kit, get back layered, editable designs with real text, vectors, and images. Not a template fill. Not a flat image. A complete, on-brand design you can edit and export.

With Sivi's APIs and SDK, you can add design generation into your product, build new apps, or automate visual creation entirely with code. Every design is a fully editable vector file built from prompts or content inputs, with text, images, logos, and brand colours applied automatically.

[Get API Access](https://instant.sivi.ai/#/generate-designs?source=sivi-api)

4.8/5 | 176K+ brands | 72+ languages

The Sivi design API lets platforms generate layered designs on demand from a short brief.

## Why choose Sivi design API integration?

- **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.

[Get API Access](https://instant.sivi.ai/#/generate-designs?source=sivi-api)

Template APIs fill in blanks. Image generation APIs produce pixels. The Sivi design API generates free-form, layered designs with real text you can actually click and edit.

## What makes Sivi design API different?

- **Layered, editable output**: The API returns a free-form 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**: Text is placed as real, selectable, editable text on independent layers. Never rendered as pixels. Never hallucinated. The API guarantees that the text in the output matches the text in your input.
- **Layout composition engine**: The LDM does not stretch, crop, or scale. It re-composes the entire layout for each target dimension. A 728×90 leaderboard and a 1080×1080 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.

[Get API Access](https://instant.sivi.ai/#/generate-designs?source=sivi-api)

The output is not a screenshot. It is a layered file, with every text block, image and vector on its own layer.

## Sivi API request lifecycle

### Phase 1: Request

POST a JSON payload to [designs-from-prompt](https://sivi.ai/developer/docs/sivi-api/core-api/designs-from-prompt) with a natural language prompt, or to [designs-from-content](https://sivi.ai/developer/docs/sivi-api/core-api/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: ~1-2 min. 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.

[Get API Access](https://instant.sivi.ai/#/generate-designs?source=sivi-api)

## Code samples

### Generate a design (cURL)

```
curl -X POST "https://connect.sivi.ai/api/prod/v2/general/designs-from-prompt" \
  -H "sivi-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "displayAds",
    "subtype": "displayAds-square",
    "dimension": { "width": 1080, "height": 1080 },
    "prompt": "Summer sale banner for urban clothing brand",
    "language": "english",
    "numOfVariants": 2
  }'
```

### Generate a design (Python)

```
import requests

response = requests.post(
    "https://connect.sivi.ai/api/prod/v2/general/designs-from-prompt",
    headers={"sivi-api-key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
        "type": "displayAds",
        "subtype": "displayAds-square",
        "dimension": {"width": 1080, "height": 1080},
        "prompt": "Summer sale banner for urban clothing brand",
        "language": "english",
        "numOfVariants": 2
    }
)

result = response.json()
design_id = result["body"]["designId"]

# Retrieve the generated variants
variants_response = requests.post(
    "https://connect.sivi.ai/api/prod/v2/general/get-design-variants",
    headers={"sivi-api-key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={"designId": design_id, "type": "generated", "limit": 10}
)

variants = variants_response.json()
for v in variants["body"]["variations"]:
    print(f"Image: {v['variantImageUrl']}")
    print(f"Edit: {v['variantEditLink']}")
```

### Generate a design (Node.js)

```
const response = await fetch("https://connect.sivi.ai/api/prod/v2/general/designs-from-prompt", {
  method: "POST",
  headers: {
    "sivi-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    type: "displayAds",
    subtype: "displayAds-square",
    dimension: { width: 1080, height: 1080 },
    prompt: "Summer sale banner for urban clothing brand",
    language: "english",
    numOfVariants: 2
  })
});

const result = await response.json();
const designId = result.body.designId;

// Retrieve the generated variants
const variantsRes = await fetch("https://connect.sivi.ai/api/prod/v2/general/get-design-variants", {
  method: "POST",
  headers: {
    "sivi-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ designId, type: "generated", limit: 10 })
});

const variants = await variantsRes.json();
variants.body.variations.forEach(v => {
  console.log(`Image: ${v.variantImageUrl}`);
  console.log(`Edit: ${v.variantEditLink}`);
});
```

## What does the output look like?

Other APIs return flat images. The Sivi API returns layered, free-form design files.

| Spec | Detail |
| --- | --- |
| Authentication | API key (sivi-api-key header) |
| Input | JSON payload: text prompt, content blocks, brand kit ID, size, language, style |
| Output formats | HTML, JPG, PNG, PDF |
| Languages | 72+ including RTL (Arabic, Hebrew, Urdu) |
| Custom sizes | Any pixel dimension, no aspect ratio restrictions |
| Rate limits | Plan-dependent. Pro: 300 credits/month. Power: 600/month. Agency & Business: 375/seat/month |
| Latency | Typical generation ~1-2 min per design |
| Concurrent requests | Supported on all plans |
| Webhooks | Async generation with webhook callbacks on completion |

With the design API, one brief becomes layered designs in every size you request.

## 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.

[Get API Access](https://instant.sivi.ai/#/generate-designs?source=sivi-api)

Design API output is built element by element, so your code can address every layer.

## 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 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](https://sivi.ai/usecases/header-creator), 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.

[Get API Access](https://instant.sivi.ai/#/generate-designs?source=sivi-api)

The Sivi design API is a REST API, so any backend that can make an HTTP request can call it.

## 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](https://instant.sivi.ai/) and make your first call. The [quickstart](https://sivi.ai/developer/docs/sivi-api/core-api/core-overview) 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)](https://sivi.ai/large-design-model) 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 free-form, 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](https://sivi.ai/compare/canva-api-vs-sivi-api)

### 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

### 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.

[Ask Us Anything](mailto: hello@sivi.ai)

Get an API key and make your first design API call from the developer docs.

Human-readable page: https://sivi.ai/api