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

# Introduction

> Welcome to the Submagic API - Transform your videos with AI-powered captions and effects

# Welcome to the Submagic API

The Submagic API allows you to programmatically generate AI-powered captions for your videos and create engaging short-form clips from YouTube content. Whether you're building a video editing platform, content management system, or automating your video workflow, our API provides enterprise-grade video processing capabilities.

## What can you do with Submagic API?

<CardGroup cols={2}>
  <Card title="AI Captions" icon="closed-captioning">
    Generate accurate, styled captions in 100+ languages with automatic
    transcription
  </Card>

  <Card title="Magic Clips" icon="scissors">
    Automatically generate engaging short-form clips from YouTube videos using
    AI
  </Card>

  <Card title="Video Templates" icon="palette">
    Apply professional templates with animated text, emojis, and visual effects
  </Card>

  <Card title="Multi-language Support" icon="globe">
    Transcribe videos in over 100 languages with high accuracy
  </Card>

  <Card title="Webhook Integration" icon="webhook">
    Receive real-time notifications when your video processing is complete
  </Card>

  <Card title="MCP Server" icon="plug">
    Drive Submagic from Claude Code, Claude Desktop, Cursor, or any
    MCP-compatible AI assistant
  </Card>
</CardGroup>

## Quick Start

Get started with the Submagic API in 3 simple steps:

<Steps>
  <Step title="Get your API Key">
    Sign up for a Submagic account at [https://app.submagic.co/signup](https://app.submagic.co/signup) and
    generate your API key from the account settings
  </Step>

  <Step title="Make your first request">
    Upload a video or provide a video URL to start processing
  </Step>

  <Step title="Retrieve your results">
    Download your processed video with captions and effects applied
  </Step>
</Steps>

## Example Request

Here's a quick example of how to create a project with a video URL:

```bash theme={null}
curl -X POST "https://api.submagic.co/v1/projects" \
  -H "x-api-key: sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My First Video",
    "language": "en",
    "videoUrl": "https://drive.google.com/video.mp4",
    "templateName": "Hormozi 2"
  }'
```

## Rate Limits

The Submagic API implements different rate limits based on the type of operation:

* **Lightweight operations** (languages, templates): 1000 requests/hour
* **Standard operations** (project retrieval): 500 requests/hour
* **Upload operations** (project creation, file uploads): 500 requests/hour
* **Export operations** (project export): 50 requests/hour

## Support

Need help getting started? We're here to help:

* 📧 **Email Support**: [support@submagic.co](mailto:support@submagic.co)
* 💬 **Community**: Join our \[Discord] ([https://discord.gg/submagic](https://discord.gg/submagic)) community
* 📖 **Documentation**: Complete API reference and guides

<Card title="Ready to get started?" icon="rocket">
  [Generate your API key](https://app.submagic.co/account) and start
  transforming your videos with AI
</Card>

{" "}