# Quick Start

Get started with MIPPIA API in minutes.

## Step 1: Get Your API Key

Sign up at [platform.mippia.com](https://platform.mippia.com) and generate your API key from the dashboard.


## Step 2: Make Your First Request

Detect if a track is AI-generated:

```bash
curl https://platform.mippia.com/api/v1/ai-detection/standard \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -X POST \
  -F "file=@/path/to/your/track.mp3"
```

You'll receive a task ID:

```json
{
  "taskId": "task_20251210021802_AjHwAeUR",
}
```

## Step 3: Get Results

You can receive results in two ways:

### Option A: Webhook (Recommended)

Set up a webhook endpoint in your dashboard. When processing completes, we'll send a POST request to your configured URL:

```json
{
  "taskResultId": 34,
  "title": "track",
  "aiModelName": "standard",
  "url": "/api/v1/ai-detection/standard",
  "taskId": "task_20251210021802_AjHwpPUR",
  "requestedAt": "2025-12-10T02:18:01.327867Z",
  "completedAt": null,
  "status": "processing",
  "result": {
    "track.mp3": {
      "model_0": { 
        "overall_analysis": { 
          "prediction": "real", 
          "confidence": 0.923 
        } 
      },
      "model_1": {
        "segment_analysis": { /* ... */ },
        "overall_analysis": { 
          "prediction": "real", 
          "confidence": 0.945 
        } 
      }
    }
  }
}
```

### Option B: Polling

Poll the task result endpoint until processing completes:

```bash
curl https://platform.mippia.com/api/v1/task/result/task_20251210021802_AjHwAeUR \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Pending response:**

```json
{
  "task_id": "task_20251210021802_AjHwAeUR",
  "status": "pending"
}
```

**Completed response:**

```json
{
  "task_id": "task_20251210021802_AjHwAeUR",
  "status": "success",
  "model_type": "standard",
  "completed_at": "2025-12-04T05:30:15Z",
  "result": {
    "track.mp3": {
      "model_0": { 
        "overall_analysis": { 
          "prediction": "real", 
          "confidence": 0.923 
        } 
      },
      "model_1": {
        "segment_analysis": { /* ... */ },
        "overall_analysis": { 
          "prediction": "real", 
          "confidence": 0.945 
        } 
      }
    }
  }
}
```

> **Tip:** We recommend polling every 5-10 seconds. Processing typically takes 30-60 seconds depending on track length.


## Next Steps

- [Set up webhooks](../guides/webhooks.md)
- [API Reference](../api-reference/ai-detection.md)