add pro-v2 model

Author: slslslrhfem

.omc/project-memory.json

@@ -0,0 +1,169 @@
+{
+  "version": "1.0.0",
+  "lastScanned": 1775048068241,
+  "projectRoot": "/home/seonghyeon/Desktop/coding/Projects_refactoring/MIPPIA_api/mippia-platform-api-project/api_docs_project/docs",
+  "techStack": {
+    "languages": [
+      {
+        "name": "Python",
+        "version": null,
+        "confidence": "high",
+        "markers": [
+          "requirements.txt"
+        ]
+      },
+      {
+        "name": "C/C++",
+        "version": null,
+        "confidence": "high",
+        "markers": [
+          "Makefile"
+        ]
+      }
+    ],
+    "frameworks": [],
+    "packageManager": "pip",
+    "runtime": null
+  },
+  "build": {
+    "buildCommand": "make build",
+    "testCommand": "make test",
+    "lintCommand": null,
+    "devCommand": null,
+    "scripts": {}
+  },
+  "conventions": {
+    "namingStyle": null,
+    "importStyle": null,
+    "testPattern": null,
+    "fileOrganization": null
+  },
+  "structure": {
+    "isMonorepo": false,
+    "workspaces": [],
+    "mainDirectories": [],
+    "gitBranches": null
+  },
+  "customNotes": [],
+  "directoryMap": {
+    "_build": {
+      "path": "_build",
+      "purpose": null,
+      "fileCount": 0,
+      "lastAccessed": 1775048068237,
+      "keyFiles": []
+    },
+    "_static": {
+      "path": "_static",
+      "purpose": null,
+      "fileCount": 10,
+      "lastAccessed": 1775048068237,
+      "keyFiles": [
+        "CNAME",
+        "android-chrome-192x192.png",
+        "apple-touch-icon.png",
+        "custom.css",
+        "custom.js"
+      ]
+    },
+    "_templates": {
+      "path": "_templates",
+      "purpose": null,
+      "fileCount": 1,
+      "lastAccessed": 1775048068239,
+      "keyFiles": [
+        "base.html"
+      ]
+    },
+    "api-reference": {
+      "path": "api-reference",
+      "purpose": null,
+      "fileCount": 6,
+      "lastAccessed": 1775048068239,
+      "keyFiles": [
+        "ai-detection.md",
+        "dataset-management.md",
+        "lyric-plagiarism.md",
+        "lyric-transcription.md",
+        "plagiarism-detection.md"
+      ]
+    },
+    "docs-v1.0": {
+      "path": "docs-v1.0",
+      "purpose": null,
+      "fileCount": 5,
+      "lastAccessed": 1775048068239,
+      "keyFiles": [
+        "Makefile",
+        "README.md",
+        "conf.py",
+        "index.md",
+        "make.bat"
+      ]
+    },
+    "docs-v1.1": {
+      "path": "docs-v1.1",
+      "purpose": null,
+      "fileCount": 4,
+      "lastAccessed": 1775048068240,
+      "keyFiles": [
+        "Makefile",
+        "conf.py",
+        "index.md",
+        "requirements.txt"
+      ]
+    },
+    "getting-started": {
+      "path": "getting-started",
+      "purpose": null,
+      "fileCount": 3,
+      "lastAccessed": 1775048068240,
+      "keyFiles": [
+        "authentication.md",
+        "introduction.md",
+        "quick-start.md"
+      ]
+    },
+    "guides": {
+      "path": "guides",
+      "purpose": null,
+      "fileCount": 1,
+      "lastAccessed": 1775048068240,
+      "keyFiles": [
+        "webhooks.md"
+      ]
+    },
+    "resources": {
+      "path": "resources",
+      "purpose": null,
+      "fileCount": 3,
+      "lastAccessed": 1775048068240,
+      "keyFiles": [
+        "pricing.md",
+        "rate-limits.md",
+        "support.md"
+      ]
+    }
+  },
+  "hotPaths": [
+    {
+      "path": "conf.py",
+      "accessCount": 3,
+      "lastAccessed": 1775048223028,
+      "type": "file"
+    },
+    {
+      "path": "api-reference/ai-detection.md",
+      "accessCount": 2,
+      "lastAccessed": 1775048216183,
+      "type": "file"
+    },
+    {
+      "path": "docs-v1.1/api-reference/ai-detection.md",
+      "accessCount": 1,
+      "lastAccessed": 1775048156968,
+      "type": "file"
+    }
+  ],
+  "userDirectives": []
+}

.omc/state/hud-state.json

@@ -0,0 +1,6 @@
+{
+  "timestamp": "2026-04-01T12:54:43.669Z",
+  "backgroundTasks": [],
+  "sessionStartTimestamp": "2026-04-01T12:54:40.100Z",
+  "sessionId": "906c59ae-fe21-4606-8702-dae6f922eb6a"
+}

.omc/state/hud-stdin-cache.json

@@ -0,0 +1 @@
+{"session_id":"906c59ae-fe21-4606-8702-dae6f922eb6a","transcript_path":"/home/seonghyeon/.claude/projects/-home-seonghyeon-Desktop-coding-Projects-refactoring-MIPPIA-api-mippia-platform-api-project-api-docs-project-docs/906c59ae-fe21-4606-8702-dae6f922eb6a.jsonl","cwd":"/home/seonghyeon/Desktop/coding/Projects_refactoring/MIPPIA_api/mippia-platform-api-project/api_docs_project/docs","model":{"id":"claude-opus-4-6[1m]","display_name":"Opus 4.6 (1M context)"},"workspace":{"current_dir":"/home/seonghyeon/Desktop/coding/Projects_refactoring/MIPPIA_api/mippia-platform-api-project/api_docs_project/docs","project_dir":"/home/seonghyeon/Desktop/coding/Projects_refactoring/MIPPIA_api/mippia-platform-api-project/api_docs_project/docs","added_dirs":[]},"version":"2.1.89","output_style":{"name":"default"},"cost":{"total_cost_usd":0.6494222499999999,"total_duration_ms":162791,"total_api_duration_ms":128854,"total_lines_added":128,"total_lines_removed":16},"context_window":{"total_input_tokens":404,"total_output_tokens":8012,"context_window_size":1000000,"current_usage":{"input_tokens":3,"output_tokens":175,"cache_creation_input_tokens":683,"cache_read_input_tokens":39287},"used_percentage":4,"remaining_percentage":96},"exceeds_200k_tokens":false,"rate_limits":{"five_hour":{"used_percentage":2,"resets_at":1775062800},"seven_day":{"used_percentage":68,"resets_at":1775192400}}}

.omc/state/idle-notif-cooldown.json

@@ -0,0 +1,3 @@
+{
+  "lastSentAt": "2026-04-01T12:57:09.920Z"
+}

.omc/state/last-tool-error.json

@@ -0,0 +1,7 @@
+{
+  "tool_name": "Bash",
+  "tool_input_preview": "{\"command\":\"ls /home/seonghyeon/Desktop/coding/Projects_refactoring/MIPPIA_api/mippia-platform-api-project/.github/workflows/ 2>/dev/null\",\"description\":\"Check for GitHub Actions workflows\"}",
+  "error": "Exit code 2",
+  "timestamp": "2026-04-01T12:55:08.644Z",
+  "retry_count": 1
+}

api-reference/ai-detection.md

@@ -12,13 +12,13 @@ Detect AI-generated music.
 
 | Name | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| `model_name` | string | Yes | Model to use: `lite`, `standard`, `pro` |
+| `model_name` | string | Yes | Model to use: `lite`, `standard`, `pro`, `pro-v2` |
 
 ### Request Body
 
-| Field      | Type | Required | Description |
-|:-----------| :--- | :--- | :--- |
-| `musicId` | string   | Unique music identifier      | uploaded via `[POST] /api/v1/music` endpoint |
+| Field | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| `file` | binary | Yes | Audio file to analyze (mp3, wav, flac, m4a, aac, ogg) |
 
 ---
 
@@ -29,6 +29,7 @@ Detect AI-generated music.
 | `lite` | 30-40 seconds | Single model, fast detection |
 | `standard` | 30-40 seconds | Model ensemble, balanced accuracy |
 | `pro` | ~1 minute | Model ensemble with detailed classification |
+| `pro-v2` | ~15 seconds | AI tracking with role-based detection |
 
 ---
 
@@ -38,10 +39,9 @@ Detect AI-generated music.
 
 ```bash
 curl https://platform.mippia.com/api/v1/ai-detection/standard \
-  -X POST \
   -H "Authorization: Bearer YOUR_API_KEY" \
-  -H "Content-Type: application/json" \
-  -d '{"musicId": "YOUR_MUSIC_ID"}'
+  -X POST \
+  -F "file=@/path/to/audio.mp3"
 ```
 
 ### Python
@@ -51,16 +51,14 @@ import requests
 
 url = "https://platform.mippia.com/api/v1/ai-detection/standard"
 headers = {
-    "Authorization": "Bearer YOUR_API_KEY",
-    "Content-Type": "application/json"
+    "Authorization": "Bearer YOUR_API_KEY"
 }
-data = {
-    "musicId": "YOUR_MUSIC_ID"
+files = {
+    "file": open("/path/to/audio.mp3", "rb")
 }
 
-response = requests.post(url, headers=headers, json=data)
+response = requests.post(url, headers=headers, files=files)
 print(response.json())
-
 ```
 
 ## Response (Initial)
@@ -258,6 +256,117 @@ Pro model includes additional classifiers for detailed analysis:
 }
 ```
 
+## Callback Response (Completed - Pro-V2)
+
+Pro-V2 model includes role-based AI detection with separate 2-label and 5-label classifiers:
+
+```json
+{
+  "task_id": "task_20251204052920_J8uNdq5z",
+  "status": "success",
+  "model_type": "pro-v2",
+  "completed_at": "2025-12-04T05:30:20Z",
+  "result": {
+    "audio_filename.mp3": {
+      "final_result": {
+        "prediction": "fake",
+        "confidence": 0.8234
+      },
+      "model_results": [
+        {
+          "segment_analysis": {
+            "prediction": ["real", "fake", "real", "fake"],
+            "confidence": [0.912, 0.834, 0.901, 0.823]
+          },
+          "overall_analysis": {
+            "prediction": "fake",
+            "confidence": 0.8775
+          },
+          "config": {
+            "model_id": "2label_stage1",
+            "analysis_focus": "Waveform & Melody Pattern",
+            "task": "Real/Fake Binary Classification",
+            "num_classes": 2,
+            "labels": ["real", "fake"]
+          }
+        },
+        {
+          "overall_analysis": {
+            "prediction": "fake",
+            "confidence": 0.8654
+          },
+          "config": {
+            "model_id": "2label_stage2",
+            "analysis_focus": "Waveform & Melody Pattern",
+            "task": "Real/Fake Binary Classification",
+            "num_classes": 2,
+            "labels": ["real", "fake"]
+          }
+        },
+        {
+          "segment_analysis": {
+            "prediction": [["tracker", "engineer"], ["topliner"], ["real"], ["vocalist", "tracker"]],
+            "confidence": [
+              {"real": 0.05, "tracker": 0.62, "topliner": 0.12, "lyricist": 0.08, "vocalist": 0.08, "engineer": 0.65},
+              {"real": 0.10, "tracker": 0.15, "topliner": 0.78, "lyricist": 0.05, "vocalist": 0.12, "engineer": 0.10},
+              {"real": 0.92, "tracker": 0.03, "topliner": 0.02, "lyricist": 0.01, "vocalist": 0.02, "engineer": 0.03},
+              {"real": 0.08, "tracker": 0.71, "topliner": 0.05, "lyricist": 0.03, "vocalist": 0.56, "engineer": 0.12}
+            ]
+          },
+          "overall_analysis": {
+            "prediction": ["tracker", "topliner", "vocalist", "engineer"],
+            "confidence": {
+              "real": 0.06,
+              "tracker": 0.62,
+              "topliner": 0.48,
+              "lyricist": 0.04,
+              "vocalist": 0.45,
+              "engineer": 0.58
+            }
+          },
+          "config": {
+            "model_id": "5label_stage1",
+            "analysis_focus": "Role-based AI Detection",
+            "task": "Multi-role AI Detection",
+            "num_classes": 6,
+            "labels": ["real", "tracker", "topliner", "lyricist", "vocalist", "engineer"]
+          }
+        },
+        {
+          "segment_analysis": {
+            "prediction": [["tracker", "engineer"], ["topliner"], ["real"], ["vocalist", "tracker"]],
+            "confidence": [
+              {"real": 0.04, "tracker": 0.65, "topliner": 0.10, "lyricist": 0.07, "vocalist": 0.09, "engineer": 0.68},
+              {"real": 0.09, "tracker": 0.14, "topliner": 0.80, "lyricist": 0.04, "vocalist": 0.11, "engineer": 0.09},
+              {"real": 0.94, "tracker": 0.02, "topliner": 0.01, "lyricist": 0.01, "vocalist": 0.01, "engineer": 0.02},
+              {"real": 0.07, "tracker": 0.73, "topliner": 0.04, "lyricist": 0.02, "vocalist": 0.59, "engineer": 0.13}
+            ]
+          },
+          "overall_analysis": {
+            "prediction": ["tracker", "topliner", "vocalist", "engineer"],
+            "confidence": {
+              "real": 0.04,
+              "tracker": 0.64,
+              "topliner": 0.50,
+              "lyricist": 0.03,
+              "vocalist": 0.47,
+              "engineer": 0.60
+            }
+          },
+          "config": {
+            "model_id": "5label_stage2",
+            "analysis_focus": "Role-based AI Detection",
+            "task": "Multi-role AI Detection",
+            "num_classes": 6,
+            "labels": ["real", "tracker", "topliner", "lyricist", "vocalist", "engineer"]
+          }
+        }
+      ]
+    }
+  }
+}
+```
+
 ## Result Fields
 
 | Field | Type | Description |
@@ -310,6 +419,7 @@ The result is an object where:
 | :--- | :--- |
 | Waveform & Melody Pattern | Analyzes audio waveform characteristics and melodic patterns |
 | Mixing & Audio Effects | Analyzes mixing techniques and audio effect signatures |
+| Role-based AI Detection | Analyzes AI involvement by musical role (tracking, toplining, lyrics, vocals, engineering) |
 
 ### Analysis Result Fields
 
@@ -329,11 +439,13 @@ The result is an object where:
 | Real/Fake Binary | `real`, `fake` |
 | 3-Class | `real`, `ai_cover`, `fake` |
 | Detailed Fake Source | `real`, `suno_v4`, `suno_v4_5`, `suno_v4_5_plus`, `suno_v5`, `other` |
+| Multi-role AI | `real`, `tracker`, `topliner`, `lyricist`, `vocalist`, `engineer` |
 
 ## Notes
 
 - **Supported formats**: mp3, wav, flac, m4a, aac, ogg
 - **Final Result**: Weighted average of all Real/Fake binary classification models for a single consolidated prediction
 - **Segment Analysis**: Analyzes each segment of the audio independently to detect localized AI artifacts
 - **Overall Analysis**: Considers the entire song structure and aggregates segment results for final prediction
-- **Model Results**: Each element in the `model_results` array represents one model's analysis
+- **Model Results**: Each element in the `model_results` array represents one model's analysis
+- **Pro-V2 Role Detection**: The 5-label models detect AI involvement by musical role. For segment-level analysis, prediction is an array of arrays where each segment contains detected roles (or `["real"]` if no AI detected). Confidence provides per-role probabilities for each segment. At the overall level, prediction lists all detected roles, and confidence aggregates role probabilities across segments.