Quick Start¶

Get started with MIPPIA API in minutes.

Step 1: Get Your API Key¶

Step 2: Make Your First Request¶

Detect if a track is AI-generated:

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:

{
  "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:

{
  "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:

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

Pending response:

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

Completed response:

{
  "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.