ייצור

תיעוד Mixanalytic API

מדריך ה-API הרשמי עבור https://mixanalytic.com. אפשר להעלות אודיו ולקבל ניתוח מיקס באמצעות AI, עם בחירת מודולים ותגובה מקוצרת או מלאה.

כתובת בסיס: https://mixanalytic.com/api

אימות

שלחו את מפתח ה-API בכותרת X-API-Key בכל בקשה.

curl -X GET "https://mixanalytic.com/api/test-data" \
  -H "X-API-Key: YOUR_API_KEY"

401 מפתח חסר או לא תקין
403 מפתח של תוכנית חינמית ללא גישת API
429 מגבלת הקצב נחצתה

תחומי הרשאה: write מיועד להעלאה/ניתוח של Mixanalytic. content קורא נתוני מחקר של תוכן מוצהר. content_write שומר טיוטות תוכן שאינן פומביות. תחומי תוכן הם רק לניהול.

נקודות קצה

שיטה	נתיב	מטרה
GET	/api/test-data	בדיקת חיבור ואימות.
POST	/api/upload	העלאה וניתוח של קובץ אודיו.
GET	/api/analyze/<file_id>	ניתוח חוזר לפי מזהה קובץ, אם הקובץ המקורי עדיין קיים.
GET	/api/content/analysis-feed	פיד מחקר ללא פרטים מזהים לסוכני תוכן, למנהלים בלבד.
POST	/api/content/drafts	נקודת קצה לשמירה ולעדכון טיוטות עבור סוכני תוכן, למנהלים בלבד.
GET	/api/ai-stats?days=30	נתוני שימוש לניתוח AI.

בקשת העלאה

POST/api/upload

שדה	סוג	חובה	הערות
file	multipart file	כן	מותרים: mp3, wav, flac, m4a, aac, ogg. עד 95MB.
modules	string/list	לא	אם לא צוין, ברירת המחדל היא כל המודולים.
detail_level	string	לא	full (ברירת מחדל) או summary.

ערך detail_level לא תקין מחזיר 400. קבצים גדולים מדי מחזירים 413.

בחירת מודולים

השתמשו ב-modules כדי לשלוט אילו מודולי ניתוח יחושבו ויוחזרו.

פורמטים נתמכים:

מחרוזת מופרדת בפסיקים: modules=frequency_balance,clarity,mood
מחרוזת מערך JSON: modules=["frequency_balance","clarity","mood"]
מפתח חוזר (שאילתה/טופס): modules=frequency_balance&modules=clarity
כל המודולים: modules=all או modules=*

מודול	תיאור
frequency_balance	ציון תדרים ואיזון בשבעה תחומים.
dynamic_range	טווח דינמי, גורם פסגה ו-PLR.
stereo_field	מדדי רוחב, פאזה וקורלציה.
clarity	מדדי בהירות והפרדה ספקטרלית.
harmonic_content	סולם ומורכבות הרמונית.
transients	נתוני התקף, צפיפות טרנזיינטים ועוצמת תדרים נמוכים.
3d_spatial	עקביות גובה, עומק ורוחב.
surround_compatibility	תאימות מונו וציון פאזה.
headphone_optimization	ציון התאמה לניגון באוזניות.
speaker_optimization	ציון התאמה לניגון ברמקולים.
genre	סיווג ז׳אנר ורמת ביטחון.
voice	נוכחות שירה ומאפייני קול.
instruments	זיהוי כלי נגינה ונתוני עיבוד מוזיקלי.
mood	פרופיל מצב רוח עם אנרגיה וערכיות.
keywords	מילות מפתח סמנטיות ותגיות.
loudness	מדדו LUFS, פיק אמיתי, קליפינג ויעדי סטרימינג כדי שהמאסטר יישמע חזק מספיק ללא עיוות, פסגות קודק או הפתעות בפלטפורמה.
noise	מדדו רצפת רעש, זמזום חשמל, שריקה וארטיפקטים כדי לנקות הקלטות לפני שהמאסטרינג מגביר אותן ומקשה להסתיר את הבעיות.
format_quality	בדקו קידוד מאבד, חיתוך ספקטרלי ועומק ביט כדי להימנע ממאסטרינג בטעות מתוך מקור MP3, AAC או אודיו שהוגדל באיכות ירודה לפני הפרסום.
reference	ייחוס
visualizations	כתובות לנכסים חזותיים שנוצרו מהניתוח.
ai_insights	סיכום והמלצות שנוצרו באמצעות מודל שפה.

שליטה בגודל התגובה

השתמשו ב-detail_level:

full (ברירת מחדל): תגובה מלאה
summary: תגובה מקוצרת ללקוחות אינטרנט ומובייל

דוגמאות

1) העלאה וניתוח מלא

curl -X POST "https://mixanalytic.com/api/upload" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@/path/to/track.mp3"

2) העלאה ומודולים נבחרים

curl -X POST "https://mixanalytic.com/api/upload" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@/path/to/track.mp3" \
  -F "modules=frequency_balance,dynamic_range,genre,mood,keywords"

3) העלאה, מודולים נבחרים ותגובת סיכום

curl -X POST "https://mixanalytic.com/api/upload" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@/path/to/track.mp3" \
  -F "modules=frequency_balance,stereo_field,clarity,ai_insights" \
  -F "detail_level=summary"

4) בדיקת נקודת קצה

curl -X GET "https://mixanalytic.com/api/test-data" \
  -H "X-API-Key: YOUR_API_KEY"

5) JavaScript בצד הלקוח

const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('modules', 'frequency_balance,dynamic_range,mood,ai_insights');
formData.append('detail_level', 'summary');

const res = await fetch('https://mixanalytic.com/api/upload', {
  method: 'POST',
  headers: { 'X-API-Key': 'YOUR_API_KEY' },
  body: formData
});

const data = await res.json();
console.log(data.analysis, data.returned_modules);

מטא־נתונים בתגובה רגילה

תגובות של ניתוח מוצלח כוללות:

requested_modules
returned_modules
detail_level
available_modules

קודי שגיאה

סטטוס	משמעות	סיבה נפוצה
400	בקשה לא תקינה	מודול או detail_level לא תקינים, שדה קובץ חסר או קובץ ריק.
401	לא מורשה	מפתח API חסר, לא תקין או שפג תוקפו.
403	הגישה אסורה	תוכנית החשבון אינה מאפשרת גישת API.
404	לא נמצא	/api/analyze/<file_id> הקובץ אינו זמין עוד לאחר מחיקת פרטיות.
413	הנתונים גדולים מדי	הקובץ גדול מ-95MB.
429	מגבלת הקצב נחצתה	יותר מדי בקשות בדקה, בשעה או ביום.
500	שגיאת שרת	כשל בניתוח או בזמן הריצה.

הערות לממשק הלקוח

עבור לקוחות אינטרנט ומובייל, עדיף להשתמש ב-detail_level=summary.
כדי לצמצם השהיה וגודל תגובה, בקשו רק את המודולים הדרושים לתצוגה הראשונית.
טפלו ב-429 וב-500 באמצעות ניסיון חוזר והשהיה מדורגת.
אין לחשוף מפתחות ייצור ארוכי טווח בחבילות ציבוריות.