---
title: Embed Documentation
description: Learn how to get started with PostNitro's Embed SDK and Embed APIs to seamlessly integrate our AI-powered carousel maker into your web application.
canonical: https://postnitro.ai/docs/embed
---

# PostNitro Embed

PostNitro Embed provides three powerful ways to integrate our AI-powered carousel maker into your applications:

1. **Embed SDK** - A JavaScript library for embedding the carousel maker directly into your web application
2. **Embed APIs** - REST APIs for automating carousel creation and integrating with your workflows
3. **MCP Server** - A [Model Context Protocol](https://modelcontextprotocol.io) server that lets AI assistants like Claude and Cursor create carousels directly

> **For AI agents and LLMs:** This documentation is available in plain-markdown form. Fetch [https://postnitro.ai/docs/llms.txt](https://postnitro.ai/docs/llms.txt) for a structured index, [https://postnitro.ai/docs/llms-full.txt](https://postnitro.ai/docs/llms-full.txt) for the complete documentation in a single file, or append `.md` to any docs page URL (e.g. `https://postnitro.ai/docs/embed/api.md`) for that page as raw markdown. To create carousels directly, connect the [PostNitro MCP server](https://postnitro.ai/docs/embed/mcp) at `https://mcp.postnitro.ai/mcp`.

## Choose Your Integration Method

### 🎨 Embed SDK
Perfect for applications where you want to provide a visual interface for users to create and edit carousels directly within your website.

**Key Capabilities:**
- **Embeddable Interface**: Seamlessly embed the carousel maker into your website
- **Create and Edit Carousels**: Allow your users to create and edit carousels directly from your website
- **Real-time Preview**: Users can see their changes instantly
- **Custom Branding**: Apply your brand colors, fonts, and templates

**Best for:**
- Content management systems
- Marketing platforms
- Social media tools
- Educational platforms
- Any application where users need visual control

### ⚡ Embed APIs
Perfect for automation, bulk operations, and integrating carousel creation into your existing workflows.

**Key Capabilities:**
- **AI-Powered Generation**: Generate carousels from topics, articles, or text using AI
- **Content Import**: Import your own slide content with full control
- **Multiple Output Formats**: Get PNG images or PDF documents
- **Automation Ready**: Integrate with Make.com, Zapier, n8n, and custom applications

**Best for:**
- Marketing automation
- Content marketing workflows
- Agency operations
- Social media management
- E-commerce marketing
- Custom integrations

### 🤖 MCP Server
Perfect for AI assistants and agents. Connect once and your assistant can browse your templates, generate carousels, and fetch the finished files — conversationally.

**Key Capabilities:**
- **12 Built-in Tools**: Template/brand/preset discovery, AI generation, content import, status, and output retrieval
- **One-Call Convenience**: `generate_and_wait` and `import_and_wait` handle polling for you
- **Works Everywhere**: Claude Desktop, Claude Code, Cursor, and any Streamable HTTP MCP client
- **Same Credits & Key**: Uses your existing Embed API key and credit balance

**Best for:**
- Claude, Cursor, and other AI assistant users
- Custom AI agents and agentic workflows
- Conversational content creation

## Getting Started

### For Embed SDK
1. **Get an API Key**: Sign up at [PostNitro.ai](https://postnitro.ai) and get your API key
2. **Install the SDK**: Follow our [installation guide](https://postnitro.ai/docs/embed/sdk/installation)
3. **Initialize**: Set up the SDK in your application
4. **Start Creating**: Let your users create carousels directly in your app

### For Embed APIs
1. **Get an API Key**: Sign up at [PostNitro.ai](https://postnitro.ai) and get your Embed API key
2. **Choose Your Method**: Use AI generation or content import
3. **Make API Calls**: Start automating your carousel creation
4. **Integrate**: Connect with your favorite automation tools

### For MCP Server
1. **Get an API Key**: Sign up at [PostNitro.ai](https://postnitro.ai) and get your Embed API key
2. **Connect**: Add `https://mcp.postnitro.ai/mcp` to your MCP client with your key — see the [setup guide](https://postnitro.ai/docs/embed/mcp)
3. **Create**: Ask your AI assistant to generate carousels for you

## Pricing

### Is it free?
- **Embed SDK**: Free to use and embed, but you need an API key
- **Embed APIs**: Free plan available with 5 credits per month

### API Pricing Plans

#### Free Plan
- **Price**: $0/month
- **Credits**: 5 per month

#### Monthly Plan
- **Price**: $10/month
- **Credits**: 250 per month

> **Credit Usage:**
> - 1 credit = 1 slide/image
> - Content import: 1 credit per slide
> - AI generation: 2 credits per slide

## Use Cases

### Embed SDK Use Cases
- **Content Management Systems**: Let users create carousels for their content
- **Marketing Platforms**: Provide visual carousel creation tools
- **Educational Platforms**: Enable students to create educational content
- **Social Media Tools**: Allow users to design posts before publishing

### Embed API Use Cases
- **Content Marketing Automation**: Generate weekly LinkedIn carousels automatically
- **Agency Workflows**: Bulk generate carousel posts for multiple clients
- **Social Media Management**: Create posts from blog content automatically
- **E-commerce Marketing**: Create product showcase carousels
- **Custom Integrations**: Build your own automation workflows

## Integration Examples

### SDK Integration
```javascript
// Initialize the PostNitro SDK
import { createEditor } from "@postnitro/embed";

const editor = createEditor({
    apiKey: "your-api-key"
});

// Open the carousel maker to create a new design
editor.createDesign((data) => {
    console.log('Carousel exported:', data);
    // data: { id, name, size, type, data: Blob | Blob[] }
});
```

### API Integration
```bash
# Generate a carousel using AI
curl --location 'https://embed-api.postnitro.ai/post/initiate/generate' \
--header 'Content-Type: application/json' \
--header 'embed-api-key: your-api-key' \
--data '{
    "postType": "CAROUSEL",
    "templateId": "your-template-id",
    "brandId": "your-brand-id",
    "aiGeneration": {
        "type": "text",
        "context": "Create a LinkedIn carousel about digital marketing tips"
    }
}'
```

### MCP Integration
```json
// Add to your MCP client configuration (Claude Desktop, Cursor, etc.)
{
  "mcpServers": {
    "postnitro": {
      "type": "http",
      "url": "https://mcp.postnitro.ai/mcp",
      "headers": {
        "Authorization": "Bearer pn-your-api-key-here"
      }
    }
  }
}
```

## Next Steps

### For SDK Users
- [Installation Guide](https://postnitro.ai/docs/embed/sdk/installation)
- [Initialization](https://postnitro.ai/docs/embed/sdk/initialization)
- [Creating/Updating Carousels](https://postnitro.ai/docs/embed/sdk/creating-updating-carousels)
- [Examples](https://postnitro.ai/docs/embed/sdk/examples)

### For API Users
- [API Overview](https://postnitro.ai/docs/embed/api)
- [AI Generation](https://postnitro.ai/docs/embed/api/initiate/generate)
- [Content Import](https://postnitro.ai/docs/embed/api/initiate/import)
- [Check Request Status](https://postnitro.ai/docs/embed/api/request-status)
- [Get Post Output](https://postnitro.ai/docs/embed/api/post-output)
- [Subscription Management](https://postnitro.ai/docs/embed/api/subscription)

### For AI Agent Users
- [MCP Server Setup & Tools](https://postnitro.ai/docs/embed/mcp)

## Support

- **Email Support**: [support@postnitro.ai](mailto:support@postnitro.ai)
- **Live Chat**: Available on [postnitro.ai](https://postnitro.ai)
- **Documentation**: Comprehensive guides for both SDK and APIs

Ready to get started? Choose your integration method and begin creating amazing carousel content!