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

# Quick Start

> Get started with Poesius API in minutes

## Step 1: Get Your API Token

1. **Log in to the Web App**: Visit `https://app.poesius.com` and sign in
2. **Navigate to API Keys**: Go to your account settings or API keys section
3. **Create an API Key**:
   * Click "Create API Key"
   * Provide a name (e.g., "automation-key")
   * Optionally add a description
   * **Important**: Copy the key immediately - it's only shown once!

## Step 2: Generate Your First Presentation

### Using REST API

```bash theme={null}
curl -X POST "https://poe.poesius.com/api/v1/slides/generate-from-doc" \
  -H "X-API-Key: pk_your_api_key_here" \
  -F "document=@/path/to/your/document.pdf" \
  -F "instructions=Create a professional presentation" \
  -F "num_slides=15"
```

### Using MCP (for AI Assistants)

```json theme={null}
{
  "method": "tools/call",
  "params": {
    "name": "generate_slides",
    "arguments": {
      "topic": "Introduction to Machine Learning",
      "instructions": "Create a comprehensive presentation",
      "num_slides": 15
    }
  }
}
```

## Step 3: Check Status

```bash theme={null}
curl -X GET "https://poe.poesius.com/api/v1/presentations/{presentation_id}" \
  -H "X-API-Key: pk_your_api_key_here"
```

## Step 4: Download Your Presentation

```bash theme={null}
curl -X GET "https://poe.poesius.com/api/v1/presentations/{presentation_id}/download" \
  -H "X-API-Key: pk_your_api_key_here" \
  -o presentation.pptx
```

## Next Steps

<Card title="Authentication Guide" icon="key" href="/authentication">
  Learn more about authentication methods and API keys.
</Card>

<Card title="API Usage" icon="server" href="/api/overview">
  Explore the full REST API documentation.
</Card>

<Card title="MCP Usage" icon="robot" href="/mcp/overview">
  Learn about MCP integration for AI assistants.
</Card>