> ## Documentation Index
> Fetch the complete documentation index at: https://docs.autoposting.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Carousels

> Go from topic to branded, publication-ready carousel slides in minutes — AI generates copy and design, you refine and publish.

Generate multi-slide carousels for LinkedIn, Instagram, Threads, and TikTok using AI copy and design. Start from a topic or your knowledge base, refine in a canvas editor or AI chat, then publish directly to your connected accounts.

## Pipeline

<Steps>
  <Step title="Generate copy">
    Provide a topic, URL, or knowledge base. AI produces slide titles, body text, and CTAs optimized for your target platform. **Cost: 15 credits.**
  </Step>

  <Step title="Generate design">
    AI builds full slides from your copy. Choose **Template** mode (structured layouts) or **AI design** mode (fully generated design). **Cost: 15 credits.**
  </Step>

  <Step title="Refine">
    Edit in the canvas editor or send natural-language instructions to refine individual slides without regenerating the full deck. **Cost: 10 credits per refinement.**
  </Step>

  <Step title="Export and publish">
    Export slides as PNG/JPEG, upload assets, and create a scheduled post draft — entering the standard publishing pipeline.
  </Step>
</Steps>

## Generate Carousel Copy

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://app.autoposting.ai/api-proxy/carousels/generate \
    -H "Authorization: Bearer sk_your_api_key" \
    -H "Content-Type: application/json" \
    -d '{
      "topic": "5 reasons to automate your social media",
      "platformPreset": "linkedin",
      "slideCount": 7,
      "brandSlug": "brand_slug"
    }'
  ```

  ```typescript TypeScript theme={null}
  const res = await fetch("https://app.autoposting.ai/api-proxy/carousels/generate", {
    method: "POST",
    headers: {
      Authorization: "Bearer sk_your_api_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      topic: "5 reasons to automate your social media",
      platformPreset: "linkedin",
      slideCount: 7,
      brandSlug: "brand_slug",
    }),
  });
  const { data } = await res.json();
  // data.slides = [{ title, body, ctaLabel, ctaUrl }]
  ```
</CodeGroup>

## Credit Costs

| Operation                          | Credits |
| ---------------------------------- | ------- |
| AI copy generation                 | 15      |
| AI design generation               | 15      |
| AI design refinement (per request) | 10      |

<Info>
  Credits are checked before each AI operation. Insufficient balance returns HTTP 402. Top up from **Billing → Buy Credits**.
</Info>

## Platform Slide Limits

| Platform  | Max Slides |
| --------- | ---------- |
| Instagram | 10         |
| Threads   | 20         |
| TikTok    | 35         |
| LinkedIn  | 100        |

## Export Settings

| Setting       | Default | Range          |
| ------------- | ------- | -------------- |
| Width         | 1080 px | 200–5000 px    |
| Height        | 1350 px | 200–5000 px    |
| Format        | PNG     | PNG or JPEG    |
| Max file size | —       | 8 MB per asset |

## Publish as a Post

After uploading exported slides, create a scheduled post draft:

```bash theme={null}
curl -X POST https://app.autoposting.ai/api-proxy/carousels/:carouselId/create-draft \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "scheduled",
    "platforms": ["linkedin", "instagram"],
    "caption": "5 reasons to automate your social media.",
    "scheduledAt": "2025-06-20T10:00:00Z",
    "brandSlug": "brand_slug"
  }'
```

| Mode            | Behavior                                           |
| --------------- | -------------------------------------------------- |
| `draft`         | Saves as draft for later editing                   |
| `scheduled`     | Queues with a future publish datetime              |
| `publish-ready` | Enqueues immediately for validation and publishing |

<CardGroup cols={2}>
  <Card title="Knowledge Base" icon="book" href="/concepts/knowledge-base">
    Ground AI copy in your own documents and research.
  </Card>

  <Card title="Posts" icon="paper-plane" href="/concepts/posts">
    Carousel drafts enter the standard post publishing pipeline.
  </Card>

  <Card title="Platforms" icon="link" href="/concepts/platforms">
    Platform-specific carousel constraints and slide limits.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Full endpoint reference for carousel management.
  </Card>
</CardGroup>