turbo@mvsep.com
توفر واجهة برمجة التطبيقات MVSEP وصولًا برمجيًا لإنشاء فصل، إرجاع النتائج، الحصول على معلومات الموقع والتحكم في قدرات المستخدم.
لاستخدام هذه الواجهة، تحتاج إلى مفتاح API. أنت غير مسجل الدخول، يرجى تسجيل الدخول للحصول على رمز API الخاص بك.
أمثلة في لغة بايثون: https://github.com/ZFTurbo/MVSep-API-Examples
تطبيق غير رسمي باسم MacVSep لنظام التشغيل Mac OS: https://github.com/septcoco/macvsep
يمكن إعداد Webhooks هنا: صفحة Webhooks
مواصفات OpenAPI: mvsep-openapi-spec.json
يرجى ملاحظة أن مستخدمي الإصدار المميز يمكنهم طلب عدد غير محدود من المهام المتزامنة، بينما لا يمكن لمستخدمي الإصدار العادي طلب سوى مهمة متزامنة واحدة.
MVSEP runs regional API endpoints. All regions share one account database, so the same account, API key and job hashes work everywhere:
https://de.mvsep.com/apihttps://hk.mvsep.com/apiRequests to https://mvsep.com/api are geo-steered to the region nearest to the caller. For API integrations we recommend calling a regional endpoint explicitly — it keeps the whole job lifecycle on one host regardless of where your requests originate from.
Every separation is processed and stored in the region where it was created, and the download URLs returned in responses always point to that region's host. For best performance, choose the endpoint closest to your servers and use the same host for the whole job lifecycle — create, status polling and file downloads.
You can query the status of any job from any region (the database is shared), but the output files themselves are always served by the region that owns the job.
لإنشاء فصل، تحتاج إلى إجراء استدعاء POST إلى العنوان التالي:
https://mvsep.com/api/separation/create
| حقل | نوع | وصف |
|---|---|---|
| api_token | سلسلة | مفتاح واجهة التطبيق الخاصة بك |
| audiofile | ثنائي | ملف الصوت المراد معالجته. لا يُشترط وجوده إذا تم تعيين المعلمة url أو إذا كان النموذج لا يستخدم إدخال الملفات. بالنسبة لنماذج المطابقة، استخدم target_audiofile وreference_audiofile كمدخلات بدلاً من audiofile. |
| url | سلسلة | رابط الملف الصوتي. لا يُشترط وجوده إذا تم تعيين المعلمة audiofile. |
| remote_type | سلسلة | (اختياري) نوع الوصول عن بُعد لملف الصوت. القيمة الافتراضية هي direct. لا يُشترط هذا الخيار إذا تم تعيين المعلمة audiofile. الأنواع المدعومة هي direct (التنزيل المباشر)، mega (MEGA)، drive (Google Drive)، dropbox (Dropbox). |
| sep_type | عدد صحيح | (اختياري) نوع الفصل، القيمة الافتراضية هي 11 (Demucs3 Model B (vocals, drums, bass, other)) |
| add_opt1 | سلسلة | (اختياري) أول حقل إضافي لنوع الفصل |
| add_opt2 | سلسلة | (اختياري) الحقل الإضافي الثاني لنوع الفصل |
| add_opt3 | سلسلة | (اختياري) نوع الفصل الحقل الإضافي الثالث |
| output_format | عدد صحيح | (اختياري) تنسيق الإخراج، القيمة الافتراضية هي 0 (mp3 (320kbps)) |
| is_demo | منطقية | (اختياري) هل يجب نشر الفصل على صفحة العرض، القيمة الافتراضية هي خطأ |
| الاسم | القيمة | حقول إضافية |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | المفتاح: add_opt1 الاسم: Output files الخيارات:
المفتاح: add_opt2 الاسم: Model Type الخيارات:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | المفتاح: add_opt1 الاسم: Output files الخيارات:
المفتاح: add_opt2 الاسم: Model Type الخيارات:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | المفتاح: add_opt1 الاسم: Output files الخيارات:
المفتاح: add_opt2 الاسم: Model Type الخيارات:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| Demucs4 HT (vocals, drums, bass, other) | 20 | المفتاح: add_opt1 الاسم: Model type الخيارات:
|
| BS Roformer (vocals, instrumental) | 40 | المفتاح: add_opt1 الاسم: Vocal model type الخيارات:
المفتاح: add_opt2 الاسم: Overlap الخيارات:
|
| BS PolarFormer (vocals, instrumental) | 123 | المفتاح: add_opt1 الاسم: Model type الخيارات:
المفتاح: add_opt2 الاسم: Overlap الخيارات:
|
| MelBand Roformer (vocals, instrumental) | 48 | المفتاح: add_opt1 الاسم: Vocal model type الخيارات:
المفتاح: add_opt2 الاسم: Overlap الخيارات:
|
| MDX23C (vocals, instrumental) | 25 | المفتاح: add_opt1 الاسم: Vocal model type الخيارات:
|
| SCNet (vocals, instrumental) | 46 | المفتاح: add_opt1 الاسم: Vocal model type الخيارات:
|
| MDX B (vocals, instrumental) | 23 | المفتاح: add_opt1 الاسم: Vocal model type الخيارات:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | المفتاح: add_opt1 الاسم: Model Type الخيارات:
المفتاح: add_opt2 الاسم: Agressiveness الخيارات:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MVSep Karaoke (lead/back vocals) | 49 | المفتاح: add_opt1 الاسم: Karaoke model type الخيارات:
المفتاح: add_opt2 الاسم: Extraction type الخيارات:
|
| MDX-B Karaoke (lead/back vocals) | 12 | المفتاح: add_opt1 الاسم: Karaoke model type الخيارات:
|
| MVSep Crowd removal (crowd, other) | 34 | المفتاح: add_opt1 الاسم: Model type الخيارات:
|
| Medley Vox (Multi-singer separation) | 53 | المفتاح: add_opt1 الاسم: Model type الخيارات:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | المفتاح: add_opt1 الاسم: Model Type الخيارات:
المفتاح: add_opt2 الاسم: Processing Mode الخيارات:
|
| MVSep Male/Female separation | 57 | المفتاح: add_opt1 الاسم: Model type الخيارات:
المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep Choir (choir, other) | 112 | المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep SATB Choir (soprano, alto, tenor, bass) | 111 | المفتاح: add_opt1 الاسم: Model type الخيارات:
المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep Drums (drums, other) | 44 | المفتاح: add_opt1 الاسم: Drums model type الخيارات:
المفتاح: add_opt2 الاسم: How to extract الخيارات:
المفتاح: add_opt3 الاسم: Output files الخيارات:
|
| MVSep Bass (bass, other) | 41 | المفتاح: add_opt1 الاسم: Bass model type الخيارات:
المفتاح: add_opt2 الاسم: How to extract الخيارات:
المفتاح: add_opt3 الاسم: Output files الخيارات:
|
| MVSep Synth (synth, other) | 88 | المفتاح: add_opt1 الاسم: How to extract الخيارات:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | المفتاح: add_opt1 الاسم: Model Type الخيارات:
المفتاح: add_opt2 الاسم: Preprocess الخيارات:
|
| MVSep Piano (piano, other) | 29 | المفتاح: add_opt1 الاسم: Piano model type الخيارات:
|
| MVSep Digital Piano (digital-piano, other) | 79 | المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep Keys (keys, other) | 106 | |
| MVSep Organ (organ, other) | 58 | المفتاح: add_opt1 الاسم: Organ model type الخيارات:
|
| MVSep Harpsichord (harpsichord, other) | 91 | |
| MVSep Accordion (accordion, other) | 99 | |
| MVSep Guitar (guitar, other) | 31 | المفتاح: add_opt1 الاسم: Guitar model type الخيارات:
|
| MVSep Acoustic Guitar (acoustic-guitar, other) | 66 | المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep Electric Guitar (electric-guitar, other) | 81 | المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep Lead/Rhythm Guitar (lead-guitar, rhythm-guitar) | 101 | المفتاح: add_opt1 الاسم: Model type الخيارات:
|
| MVSep Pedal Steel Guitar | 124 | |
| MVSep Plucked Strings (plucked-strings, other) | 102 | |
| MVSep Harp (harp, other) | 72 | |
| MVSep Mandolin (mandolin, other) | 74 | |
| MVSep Banjo (banjo, other) | 83 | |
| MVSep Sitar (sitar, other) | 90 | |
| MVSep Ukulele (ukulele, other) | 96 | |
| MVSep Dobro (dobro, other) | 97 | |
| MVSep Bowed Strings (strings, other) | 52 | المفتاح: add_opt1 الاسم: String model type الخيارات:
المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep Violin (violin, other) | 65 | |
| MVSep Viola (viola, other) | 69 | المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep Cello (cello, other) | 70 | المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep Double Bass (double-bass, other) | 73 | المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep Wind (wind, other) | 54 | المفتاح: add_opt1 الاسم: Wind model type الخيارات:
المفتاح: add_opt2 الاسم: How to extract الخيارات:
المفتاح: add_opt3 الاسم: Output files الخيارات:
|
| MVSep Brass (brass, other) | 107 | المفتاح: add_opt1 الاسم: How to extract الخيارات:
|
| MVSep Woodwind (woodwind, other) | 108 | المفتاح: add_opt1 الاسم: How to extract الخيارات:
|
| MVSep Saxophone (saxophone, other) | 61 | المفتاح: add_opt1 الاسم: Model type الخيارات:
|
| MVSep Flute (flute, other) | 67 | المفتاح: add_opt1 الاسم: Flute model type الخيارات:
المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep Trumpet (trumpet, other) | 71 | المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep Trombone (trombone, other) | 75 | المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep Oboe (oboe, other) | 77 | المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep Clarinet (clarinet, other) | 78 | المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep French Horn (french-horn, other) | 82 | المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep Harmonica (harmonica, other) | 87 | المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep Tuba (tuba, other) | 92 | |
| MVSep Bassoon (bassoon, other) | 93 | |
| MVSep Bagpipes (bagpipes , other) | 116 | المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep Percussion (percussion, other) | 105 | |
| MVSep Tambourine (tambourine, other) | 76 | |
| MVSep Marimba (marimba, other) | 84 | |
| MVSep Glockenspiel (glockenspiel, other) | 85 | |
| MVSep Timpani (timpani, other) | 86 | |
| MVSep Triangle (triangle, other) | 89 | |
| MVSep Congas (congas , other) | 94 | |
| MVSep Bells (bells, other) | 95 | |
| MVSep Wind Chimes (wind-chimes, other) | 98 | |
| MVSep Xylophone (xylophone, other) | 109 | المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep Celesta (celesta, other) | 110 | المفتاح: add_opt2 الاسم: How to extract الخيارات:
|
| MVSep Demucs4HT DNR (speech, music, effects) | 24 | المفتاح: add_opt1 الاسم: Model type الخيارات:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | المفتاح: add_opt1 الاسم: Model Type الخيارات:
|
| MVSep DnR v3 (speech, music, effects) | 56 | المفتاح: add_opt1 الاسم: Model type الخيارات:
المفتاح: add_opt2 الاسم: How to extract الخيارات:
المفتاح: add_opt3 الاسم: Output files الخيارات:
|
| MVSep Braam | 117 | |
| MVSep Risers | 125 | |
| MVSep FX | 122 | |
| Apollo Enhancers (by JusperLee, Lew, baicai1145) | 51 | المفتاح: add_opt1 الاسم: Model type الخيارات:
المفتاح: add_opt2 الاسم: Cutoff (Hz) الخيارات:
|
| Reverb Removal (noreverb) | 22 | المفتاح: add_opt1 الاسم: Model Type الخيارات:
المفتاح: add_opt2 الاسم: Preprocess الخيارات:
|
| DeNoise by aufr33 and gabox | 47 | المفتاح: add_opt1 الاسم: Model type الخيارات:
|
| AudioSR (Super Resolution) | 59 | المفتاح: add_opt1 الاسم: Cutoff (Hz) الخيارات:
|
| FlashSR (Super Resolution) | 60 | |
| Stable Audio Open Gen | 62 | المفتاح: add_opt1 الاسم: Text prompt الخيارات: المفتاح: add_opt2 الاسم: Length (in seconds) الخيارات:
|
| Whisper (extract text from audio) | 39 | المفتاح: add_opt1 الاسم: Model type الخيارات:
المفتاح: add_opt2 الاسم: Transcription type الخيارات:
|
| Parakeet (extract text from audio) | 64 | المفتاح: add_opt1 الاسم: Model type الخيارات:
المفتاح: add_opt2 الاسم: Version الخيارات:
|
| VibeVoice (Voice Cloning) | 103 | المفتاح: add_opt1 الاسم: Model type الخيارات:
المفتاح: add_opt2 الاسم: Text prompt الخيارات: المفتاح: add_opt3 الاسم: Extract vocals first الخيارات:
|
| VibeVoice (TTS) | 104 | المفتاح: add_opt1 الاسم: Model type الخيارات:
المفتاح: add_opt2 الاسم: Text prompt الخيارات: |
| Qwen3-TTS (Custom Voice) | 118 | المفتاح: add_opt1 الاسم: Text prompt الخيارات: المفتاح: add_opt2 الاسم: Speaker الخيارات:
المفتاح: add_opt3 الاسم: Language الخيارات:
المفتاح: add_opt4 الاسم: Voice description الخيارات: |
| Qwen3-TTS (Voice Design) | 119 | المفتاح: add_opt1 الاسم: Text prompt الخيارات: المفتاح: add_opt2 الاسم: Voice description الخيارات: المفتاح: add_opt3 الاسم: Language الخيارات:
|
| Qwen3-TTS (Voice Cloning) | 120 | المفتاح: add_opt1 الاسم: Text prompt الخيارات: المفتاح: add_opt2 الاسم: Reference text in audio (optional) الخيارات: المفتاح: add_opt3 الاسم: Language الخيارات:
المفتاح: add_opt4 الاسم: Extract vocals first الخيارات:
|
| Mega 53-stem Model | 126 | |
| Bark (Speech Gen) | 115 | المفتاح: add_opt1 الاسم: Text prompt الخيارات: المفتاح: add_opt2 الاسم: Speaker الخيارات:
|
| MVSep MultiSpeaker (MDX23C) | 42 | المفتاح: add_opt1 الاسم: Model Type الخيارات:
|
| Aspiration (by Sucial) | 50 | المفتاح: add_opt1 الاسم: Model type الخيارات:
|
| Phantom Centre extraction | 55 | المفتاح: add_opt1 الاسم: Model type الخيارات:
|
| Matchering (by sergree) | 68 | |
| SOME (Singing-Oriented MIDI Extractor) | 80 | المفتاح: add_opt1 الاسم: How to use الخيارات:
|
| Transkun (Piano -> MIDI) | 113 | المفتاح: add_opt1 الاسم: How to extract الخيارات:
|
| Basic Pitch (MIDI Extraction) | 114 | |
| ADTOF Plus (Drums -> MIDI) | 127 | المفتاح: add_opt1 الاسم: How to extract الخيارات:
|
| HeartMuLa (Song Gen) | 121 | المفتاح: add_opt1 الاسم: Lyrics الخيارات: المفتاح: add_opt10 الاسم: Topic الخيارات:
المفتاح: add_opt2 الاسم: Tags (optional) الخيارات: المفتاح: add_opt3 الاسم: Genre الخيارات:
المفتاح: add_opt4 الاسم: Timbre الخيارات:
المفتاح: add_opt5 الاسم: Gender الخيارات:
المفتاح: add_opt6 الاسم: Mood الخيارات:
المفتاح: add_opt7 الاسم: Instrument الخيارات:
المفتاح: add_opt8 الاسم: Scene الخيارات:
المفتاح: add_opt9 الاسم: Region الخيارات:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | المفتاح: add_opt1 الاسم: Model type الخيارات:
|
| MDX A/B (vocals, drums, bass, other) | 7 | المفتاح: add_opt1 الاسم: Vocal model type الخيارات:
|
| Vit Large 23 (vocals, instrum) | 33 | المفتاح: add_opt1 الاسم: Model type الخيارات:
|
| UVRv5 Demucs (vocals, music) | 17 | المفتاح: add_opt1 الاسم: Model Type الخيارات:
|
| MVSep DNR (music, sfx, speech) | 18 | |
| MVSep Old Vocal Model (vocals, music) | 19 | |
| Demucs2 (vocals, drums, bass, other) | 13 | |
| Danna Sep (vocals, drums, bass, other) | 15 | |
| Byte Dance (vocals, drums, bass, other) | 16 | |
| MVSep MelBand Roformer (vocals, instrum) | 35 | |
| spleeter | 0 | المفتاح: add_opt1 الاسم: Model type الخيارات:
|
| UnMix | 3 | المفتاح: add_opt1 الاسم: Model type الخيارات:
|
| Zero Shot (Query Based) (Low quality) | 14 | المفتاح: add_opt1 الاسم: Model Type الخيارات:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | المفتاح: add_opt1 الاسم: Model type الخيارات:
|
| الاسم | القيمة |
|---|---|
| mp3 (320 kbps) | 0 |
| wav (uncompressed, 16 bit) | 1 |
| flac (lossless, 16 bit) | 2 |
| m4a (lossy) | 3 |
| wav (uncompressed, 32 bit) | 4 |
| flac (lossless, 24 bit) | 5 |
curl --location --request POST 'https://mvsep.com/api/separation/create'
--form 'audiofile=@"/path/to/file.mp3"'
--form 'api_token="<رمز API الخاص بك>"'
--form 'sep_type="9"'
--form 'add_opt1="0"'
--form 'add_opt2="1"'
--form 'output_format="1"'
--form 'is_demo="1"'
| المفتاح | القيمة |
|---|---|
| success |
|
| data | يحتفظ بمعلومات إضافية حسب مفتاح success |
| data -> link | يعرض الرابط إلى URL "GET RESULT" للوظيفة المنشأة (يتم عرضه فقط عندما يكون success هو true) |
| data -> hash | يعرض تجزئة الوظيفة المنشأة (يتم عرضه فقط عندما يكون success هو true) |
| data -> message | يعرض وصفًا للخطأ (يتم عرضه فقط عندما يكون success هو false) |
تستخدم واجهة برمجة التطبيقات MVSEP الأكواد الخطأ التالية:
| رمز الخطأ | المعنى |
|---|---|
| 400 | بعض المعلمات مفقودة أو غير صالحة. يظهر هذا الخطأ عندما لا تمرر جميع المعلمات الإلزامية أو تمرر معلمات غير صالحة. |
| 401 |
api_token غير معروف أو غير صالح. يظهر هذا الخطأ إذا استخدمت مفتاح واجهة برمجة التطبيقات غير معروف
|
للحصول على نتيجة الفصل، تحتاج إلى إجراء استدعاء GET إلى العنوان التالي:
https://mvsep.com/api/separation/get
| حقل | نوع | وصف |
|---|---|---|
| hash | سلسلة | الهاش الخاص بالفصل |
| mirror | عدد صحيح | (اختياري) يستخدم مرآة أخرى إذا تم تعيينه إلى 1، الافتراضي هو 0. يتطلب api_token و 1 رصيد إذا تم تعيينه إلى 1. |
| api_token | سلسلة | (اختياري) مفتاح API للمستخدم. مطلوب إذا تم تعيين معلمة mirror إلى 1. |
curl --location --request GET 'https://mvsep.com/api/separation/get?hash=20230327071601-0e3e5c6c85-13-dimensions.mp3'
| المفتاح | القيمة |
|---|---|
| success |
|
| status |
|
| data | يحتفظ بمعلومات إضافية حسب مفتاح status |
| data -> queue_count | يعرض عدد الوظائف غير المعالجة في أولويات المستخدم (يتم عرضه فقط عندما يكون status هو waiting أو distributing) |
| data -> current_order | يعرض ترتيب وظيفة المستخدم (يتم عرضه فقط عندما يكون status هو waiting أو distributing) |
| data -> message | يعرض وصف الحالة (يتم عرضه في جميع الحالات، يعرض سبب الخطأ عندما يكون status هو failed) |
| data -> algorithm | يعرض الخوارزمية المستخدمة في الوظيفة (يتم عرضه فقط عندما يكون status هو done) |
| data -> algorithm_description | يعرض تفاصيل الخوارزمية المستخدمة في الوظيفة (يتم عرضه فقط عندما يكون status هو done) |
| data -> output_format | يعرض تنسيق الإخراج للوظيفة (يتم عرضه فقط عندما يكون status هو done) |
| data -> tags | يعرض العلامات الوصفية الصوتية (يتم عرضه فقط عندما يكون status هو done) |
| data -> input_file | يعرض تفاصيل تنزيل الملف الصوتي المدخل (يتم عرضه فقط عندما يكون status هو done) |
| data -> files | يعرض تفاصيل تنزيل الملفات الصوتية المخرجة (يتم عرضه فقط عندما يكون status هو done) |
| data -> date | يعرض تاريخ معالجة الوظيفة (يتم عرضه فقط عندما يكون status هو done) |
| data -> finished_chunks | يعرض عدد الأجزاء المنتهية لوظيفة كبيرة (يتم عرضه فقط عندما يكون status هو distributing) |
| data -> all_chunks | يعرض العدد الإجمالي للأجزاء لوظيفة كبيرة (يتم عرضه فقط عندما يكون status هو distributing) |
للحصول على نتيجة مهمة تُنفَّذ عن بُعد، عليك إجراء استدعاء GET إلى الرابط التالي:
https://mvsep.com/api/separation/get-remote
| حقل | نوع | وصف |
|---|---|---|
| hash | سلسلة | الهاش الخاص بالفصل |
curl --location --request GET 'https://mvsep.com/api/separation/get-remote?hash=n2AwBjy4KsFZfqqR'
| المفتاح | القيمة |
|---|---|
| success |
|
| status |
|
| data | يحتفظ بمعلومات إضافية حسب مفتاح status |
| data -> queue_count | يعرض عدد المهام غير المعالجة في قائمة أولويات المستخدم (يظهر فقط عندما تكون حالة status هي waiting). |
| data -> current_order | يعرض ترتيب مهمة المستخدم (يظهر فقط عندما تكون حالة status هي waiting). |
| data -> message | يعرض وصف الحالة (فقط عندما تكون status هي failed). |
| data -> link | يعرض رابطًا إلى عنوان URL الخاص بـ "الحصول على النتيجة" للمهمة التي تم إنشاؤها (يظهر فقط عندما يكون status هو done). |
| data -> hash | تجزئة عملية الفصل (لا تظهر إلا عندما يكون status هو done). |
لإلغاء عملية الفصل واسترداد الرصيد المستخدم (في حال لم يتم البدء في معالجة عملية الفصل بعد)، يتعين عليك إرسال طلب POST إلى الرابط التالي:
https://mvsep.com/api/separation/cancel
| حقل | نوع | وصف |
|---|---|---|
| api_token | سلسلة | مفتاح API الخاص بالمستخدم |
| hash | سلسلة | الهاش الخاص بالفصل |
curl --location --request POST 'https://mvsep.com/api/separation/cancel' --form 'api_token="<رمز API الخاص بك>"' --form 'hash="<hash>"'
| المفتاح | القيمة |
|---|---|
| success |
|
للحصول على بيانات مفصلة حول أنواع الفصل، يجب عليك إجراء استدعاء GET إلى الرابط التالي:
https://mvsep.com/api/app/algorithms
| حقل | نوع | وصف |
|---|---|---|
| scopes | سلسلة | ما إذا كان ينبغي إدراج النماذج التي تستخدم أشكالاً مختلفة من المدخلات.
single_upload في حالة عدم تحديدها. للحصول على جميع النماذج، قم بتعيين scopes=single_upload,no_upload,matchering_upload.
|
curl --location --request GET 'https://mvsep.com/api/app/algorithms'
يعيد البيانات على شكل مصفوفة:
| المفتاح | القيمة |
|---|---|
| render_id | قيمة نوع الفصل (ID) |
| name | اسم نوع الفصل |
| algorithm_group_id | المجموعة التي ينتمي إليها نوع الفصل: |
| algorithm_group | يحتوي على معلومات حول مجموعة الخوارزميات التي تنتمي إليها الخوارزمية. |
| algorithm_group -> name | اسم مجموعة الخوارزميات. |
| audio_widget |
نوع أداة الصوت المراد استخدامها مع الخوارزمية. يمكن استخدام هذا الخيار لتحديد كيفية عرض مشغل الصوت الخاص بالخوارزمية في الواجهة الأمامية. القيم الممكنة هي:
|
| orientation |
لمن هذا النوع من الفصل مخصص:
|
| order_id | ترتيب نوع الفصل |
| price_coefficient |
يستخدم لحساب عدد الائتمانات التي سيأخذها العمل من المستخدم المميز. يستخدم هذه الصيغة : floor(<مدة الملف الصوتي بالثواني> * price_coefficient / 60)?:1
|
| usage | يعرض عدد مرات الاستخدام الشهري لكل نوع من أنواع الفصل |
| rating | يعرض معدل الاستخدام الشهري لنوع الفصل في شكل مصفوفة:
|
| algorithm_fields | يحتوي على معلومات حول الحقول الإضافية لنوع الفصل |
| algorithm_fields -> name |
يعرض أي حقل إضافي لنوع الفصل:
|
| algorithm_fields -> text | اسم العرض للحقل الإضافي من نوع الفصل. |
| algorithm_fields -> options | سلاسل المفاتيح والقيم المشفرة بصيغة JSON للحقل الإضافي. |
| algorithm_fields -> default_key | القيمة الافتراضية للحقل الإضافي. أحد المفاتيح في <code>algorithm_fields -> options</code>. |
| algorithm_descriptions | يحتوي على معلومات حول أوصاف نوع الفصل. |
| algorithm_descriptions -> short_description | وصف صغير لنوع الفصل لا يستخدم HTML. |
| algorithm_descriptions -> long_description | وصف مفصل لنوع الفصل الذي يستخدم HTML. |
| algorithm_descriptions -> lang | رمز اللغة المحددة للوصف. |
للحصول على معلومات حول آخر الأخبار عن MVSEP، يجب إرسال طلب GET إلى الرابط التالي:
https://mvsep.com/api/app/news
| حقل | نوع | وصف |
|---|---|---|
| lang | سلسلة | (اختياري) رمز اللغة المكون من حرفين (en, ru) |
| start | عدد صحيح | (اختياري) نقطة الانطلاق، الافتراضي هو 0 (أي بدء من الأحدث) |
| limit | عدد صحيح | (اختياري) الحد الأقصى لعدد النتائج المعادة، الافتراضي هو 10، والحد الأقصى هو 20. |
curl --location --request GET 'https://mvsep.com/api/app/news?lang=en&start=2&limit=1'
يعيد البيانات على شكل مصفوفة:
| المفتاح | القيمة |
|---|---|
| title | عنوان الخبر |
| lang | عنوان الخبر |
| text | الوصف الكامل للخبر |
| created_at | تاريخ الخبر |
للحصول على معلومات حول قائمة انتظار الموقع، عليك إجراء استدعاء GET إلى الرابط التالي:
https://mvsep.com/api/app/queue
| حقل | نوع | وصف |
|---|---|---|
| api_token | سلسلة | (اختياري) مفتاح API الخاص بالمستخدم |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| المفتاح | القيمة |
|---|---|
| queue |
يحتوي على مجموعة من قوائم الانتظار الحالية لمختلف الخطط:
|
| plan |
يحتوي على قائمة الانتظار الحالية للخطة الحالية (أضف api_token إلى الطلب للحصول على الخطة المسجلة/المميزة):
|
للحصول على معلومات حول الفواصل التجريبية، يجب إرسال طلب GET إلى الرابط التالي:
https://mvsep.com/api/app/demo
| حقل | نوع | وصف |
|---|---|---|
| start | عدد صحيح | (اختياري) نقطة الانطلاق، الافتراضي هو 0 (أي بدء من الأحدث) |
| limit | عدد صحيح | (اختياري) الحد الأقصى لعدد النتائج المعادة، الافتراضي هو 10، والحد الأقصى هو 20. |
| algorithm_id | عدد صحيح | معرف نوع الفصل الاختياري. استخدم هذا الخيار لإرجاع فواصل تجريبية تم إنشاؤها بواسطة خوارزمية واحدة فقط. تتطابق القيم مع render_id من نقطة النهاية GET SEPARATION TYPES. |
| options[FIELD] | سلسلة / عدد صحيح | مرشح اختياري لقيم خيارات الخوارزمية. استبدل FIELD بمفتاح حقل إضافي من algorithm_fields -> name في استجابة GET SEPARATION TYPES، ثم مرر أحد مفاتيح options الخاصة بهذا الحقل كقيمة. مثال: options[vocals]=1. |
| additional_options | سلسلة | يحتوي الخيار "raw" على مرشح لبيانات خيارات المهام المخزنة. يُفضل استخدام options[FIELD] في عمليات التكامل الجديدة، لأنه صيغة صريحة وأسهل في التكوين. |
curl --location --request GET 'https://mvsep.com/api/app/demo?start=0&limit=2'
curl --location --request GET 'https://mvsep.com/api/app/demo?algorithm_id=20&options[vocals]=1&start=0&limit=10'
لإنشاء مرشحات الخيارات، قم أولاً باستدعاء https://mvsep.com/api/app/algorithms وافحص قائمة algorithm_fields الخاصة بكل خوارزمية. استخدم الحقل name داخل options[FIELD] واستخدم أحد مفاتيح خيارات JSON كقيمة.
يعيد البيانات على شكل مصفوفة:
| المفتاح | القيمة |
|---|---|
| hash | الهاش الخاص بالفصل |
| date | تاريخ الفصل |
| input_audio | رابط الصوت المدخل |
| size | حجم الصوت المدخل |
| algorithm | يحتوي على معلومات أساسية حول نوع الفصل المستخدم (راجع تبويب GET SEPARATION TYPES للحصول على معلومات حول المعلمات المعادة) |
للمصادقة على المستخدم والحصول على مفتاح API الخاص بالمستخدم، يجب إرسال طلب POST إلى الرابط التالي:
https://mvsep.com/api/app/login
| حقل | نوع | وصف |
|---|---|---|
| سلسلة | بريد المستخدم الإلكتروني | |
| password | سلسلة | كلمة مرور المستخدم |
curl --location --request POST 'https://mvsep.com/api/app/login' --form 'email="<بريد المستخدم الإلكتروني>"' --form 'password="<كلمة مرور المستخدم>"'
| المفتاح | القيمة |
|---|---|
| success |
|
| data | يحتوي على معلومات عندما تكون بيانات الاعتماد صحيحة |
| data -> name | اسم المستخدم |
| data -> email | بريد المستخدم الإلكتروني |
| data -> api_token | مفتاح API الخاص بالمستخدم. تأكد من تخزينه في مكان آمن واستخدامه في العمليات اللاحقة. |
| data -> premium_minutes | الرصيد المتبقي للمستخدم |
| data -> premium_enabled |
ما إذا كان المستخدم قد سمح بإنفاق الرصيد.
|
| data -> long_filenames_enabled |
ما إذا كان المستخدم يريد معلومات إضافية في أسماء الملفات:
|
تستخدم واجهة برمجة التطبيقات MVSEP الأكواد الخطأ التالية:
| رمز الخطأ | المعنى |
|---|---|
| 400 | تم إدخال بيانات اعتماد غير صحيحة |
لتسجيل المستخدم في موقع MVSEP، يجب إرسال طلب POST إلى الرابط التالي:
https://mvsep.com/api/app/register
| حقل | نوع | وصف |
|---|---|---|
| name | سلسلة | اسم المستخدم |
| سلسلة | بريد المستخدم الإلكتروني | |
| password | سلسلة | كلمة مرور المستخدم |
| password_confirmation | سلسلة | أعد إدخال كلمة مرور المستخدم |
curl --location --request GET 'https://mvsep.com/api/app/register' --form 'name="user"'
--form 'email="asdf@example.com"'
--form 'password="ASDFQWEr123"'
--form 'password_confirmation="ASDFQWEr123"'
| المفتاح | القيمة |
|---|---|
| success |
|
| message | يحدث عندما يكون النموذج صالحًا |
تستخدم واجهة برمجة التطبيقات MVSEP الأكواد الخطأ التالية:
| رمز الخطأ | المعنى |
|---|---|
| 400 | النموذج غير صالح |
للحصول على معلومات المستخدم، يجب إرسال طلب GET إلى الرابط التالي:
https://mvsep.com/api/app/user
| حقل | نوع | وصف |
|---|---|---|
| api_token | سلسلة | مفتاح API الخاص بالمستخدم |
curl --location --request GET 'https://mvsep.com/api/app/user?api_token=<رمز API الخاص بك>'
| المفتاح | القيمة |
|---|---|
| success |
|
| data | يحتوي على معلومات عندما تكون بيانات الاعتماد صحيحة |
| data -> name | اسم المستخدم |
| data -> email | بريد المستخدم الإلكتروني |
| data -> api_token | مفتاح API الخاص بالمستخدم. تأكد من تخزينه في مكان آمن واستخدامه في العمليات اللاحقة. |
| data -> premium_minutes | الرصيد المتبقي للمستخدم |
| data -> premium_enabled |
ما إذا كان المستخدم قد سمح بإنفاق الرصيد.
|
| data -> long_filenames_enabled |
ما إذا كان المستخدم يريد معلومات إضافية في أسماء الملفات:
|
| data -> current_queue | يعرض الفواصل الجارية للمستخدم |
تستخدم واجهة برمجة التطبيقات MVSEP الأكواد الخطأ التالية:
| رمز الخطأ | المعنى |
|---|---|
| 400 | مفتاح API غير صالح |
للحصول على معلومات أساسية عن تاريخ الفصول للمستخدم، يجب إرسال طلب GET إلى الرابط التالي:
https://mvsep.com/api/app/separation_history
| حقل | نوع | وصف |
|---|---|---|
| api_token | سلسلة | مفتاح API الخاص بالمستخدم |
| start | عدد صحيح | (اختياري) نقطة الانطلاق، الافتراضي هو 0 (أي بدء من الأحدث) |
| limit | عدد صحيح | (اختياري) الحد الأقصى لعدد النتائج المعادة، الافتراضي هو 10، والحد الأقصى هو 20. |
curl --location --request GET 'https://mvsep.com/api/app/separation_history?api_token=<رمز API الخاص بك>&start=1&limit=2'
| المفتاح | القيمة |
|---|---|
| success |
|
| data | يحتوي على مصفوفة من المعلومات الأساسية حول الفواصل السابقة |
| data -> hash | الهاش الخاص بالفصل |
| data -> job_exists | يحتوي على مصفوفة من المعلومات الأساسية حول الفواصل السابقة |
| data -> credits | عدد الرصيد الذي تم استخدامه للعمل، null إذا لم يكن الفصل موجودًا |
| data -> time_left | الوقت التقريبي المتبقي حتى يتم حذف العمل |
| data -> algorithm | يحتوي على معلومات أساسية حول نوع الفصل المستخدم (راجع تبويب GET SEPARATION TYPES للحصول على معلومات حول المعلمات المعادة) |
تستخدم واجهة برمجة التطبيقات MVSEP الأكواد الخطأ التالية:
| رمز الخطأ | المعنى |
|---|---|
| 400 | مفتاح API غير صالح |
لتمكين الاستخدام المتميز للمستخدم، يجب إرسال طلب POST إلى الرابط التالي:
https://mvsep.com/api/app/enable_premium
| حقل | نوع | وصف |
|---|---|---|
| api_token | سلسلة | مفتاح API الخاص بالمستخدم |
curl --location --request POST 'https://mvsep.com/api/app/enable_premium' --form 'api_token="<رمز API الخاص بك>"'
| المفتاح | القيمة |
|---|---|
| success |
|
| message | يخبر عن حالة العملية |
تستخدم واجهة برمجة التطبيقات MVSEP الأكواد الخطأ التالية:
| رمز الخطأ | المعنى |
|---|---|
| 400 | مفتاح API غير صالح |
لتعطيل الاستخدام المتميز للمستخدم، يجب إرسال طلب POST إلى الرابط التالي:
https://mvsep.com/api/app/disable_premium
| حقل | نوع | وصف |
|---|---|---|
| api_token | سلسلة | مفتاح API الخاص بالمستخدم |
curl --location --request POST 'https://mvsep.com/api/app/disable_premium' --form 'api_token="<رمز API الخاص بك>"'
| المفتاح | القيمة |
|---|---|
| success |
|
| message | يخبر عن حالة العملية |
تستخدم واجهة برمجة التطبيقات MVSEP الأكواد الخطأ التالية:
| رمز الخطأ | المعنى |
|---|---|
| 400 | مفتاح API غير صالح |
لتمكين أسماء الملفات الطويلة للمستخدم، يجب إرسال طلب POST إلى الرابط التالي:
https://mvsep.com/api/app/enable_long_filenames
| حقل | نوع | وصف |
|---|---|---|
| api_token | سلسلة | مفتاح API الخاص بالمستخدم |
curl --location --request POST 'https://mvsep.com/api/app/enable_long_filenames' --form 'api_token="<رمز API الخاص بك>"'
| المفتاح | القيمة |
|---|---|
| success |
|
| message | يخبر عن حالة العملية |
تستخدم واجهة برمجة التطبيقات MVSEP الأكواد الخطأ التالية:
| رمز الخطأ | المعنى |
|---|---|
| 400 | مفتاح API غير صالح |
لتعطيل أسماء الملفات الطويلة للمستخدم، يجب إرسال طلب POST إلى الرابط التالي:
https://mvsep.com/api/app/disable_long_filenames
| حقل | نوع | وصف |
|---|---|---|
| api_token | سلسلة | مفتاح API الخاص بالمستخدم |
curl --location --request POST 'https://mvsep.com/api/app/disable_long_filenames' --form 'api_token="<رمز API الخاص بك>"'
| المفتاح | القيمة |
|---|---|
| success |
|
| message | يخبر عن حالة العملية |
تستخدم واجهة برمجة التطبيقات MVSEP الأكواد الخطأ التالية:
| رمز الخطأ | المعنى |
|---|---|
| 400 | مفتاح API غير صالح |
للحصول على معلومات حول إدخالات قائمة انتظار "Quality Checker"، عليك إجراء استدعاء GET إلى الرابط التالي:
https://mvsep.com/api/quality_checker/queue
| حقل | نوع | وصف |
|---|---|---|
| start | عدد صحيح | (اختياري) نقطة الانطلاق، الافتراضي هو 0 (أي بدء من الأحدث) |
| limit | عدد صحيح | (اختياري) الحد الأقصى لعدد النتائج المعادة، الافتراضي هو 10، والحد الأقصى هو 20. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/queue?&start=1&limit=2'
يعيد البيانات على شكل مصفوفة:
| المفتاح | القيمة |
|---|---|
| id | رقم تعريف الإدخال |
| dataset_type | نوع مجموعة البيانات المختار عند إضافة الإدخال / نوع لوحة المتصدرين
|
| date | تاريخ إنشاء الإدخال |
| algo_name | اسم نوع/خوارزمية الفصل المستخدمة |
| main_text | وصف نوع/خوارزمية الفصل المستخدمة |
| proc | حالة المعالجة
|
| proc_remote_date | الطابع الزمني لتاريخ المعالجة |
| msg | تُرجع "OK" في حالة النجاح، وإلا تُظهر رسالة خطأ |
| metrics | معلومات حول مؤشرات الدخول |
| sdr_* (wildcard) | الوحدات من حقوق السحب الخاصة للصيغ الأساسية المقابلة |
| dataset_name | اسم مجموعة البيانات |
للحصول على معلومات حول قوائم المتصدرين في Quality Checker، عليك إرسال طلب GET إلى الرابط التالي:
https://mvsep.com/api/quality_checker/leaderboard
| حقل | نوع | وصف |
|---|---|---|
| dataset_type | سلسلة | نوع مجموعة البيانات، ويكون القيمة الافتراضية هي 0 في حالة عدم تحديدها.
|
| start | عدد صحيح | (اختياري) نقطة الانطلاق، الافتراضي هو 0 (أي بدء من الأحدث) |
| limit | عدد صحيح | (اختياري) الحد الأقصى لعدد النتائج المعادة، الافتراضي هو 10، والحد الأقصى هو 20. |
| algo_name_filter | سلسلة | تصفية أسماء أنواع/خوارزميات الفصل حسب النص المحدد |
| sort | سلسلة | الترتيب حسب قيمة SDR المحددة للجذع. يمكنك الحصول على قائمة بالقيم القابلة للترتيب لنوع مجموعة البيانات المحدد من المفتاح sortables الموجود في الرد. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/leaderboard?&start=1&limit=2&algo_name_filter=MVSep'
| المفتاح | القيمة |
|---|---|
| data | يحتوي على مجموعة من إدخالات أداة فحص الجودة. راجع قسم "استجابة GET QUEUE من أداة فحص الجودة" لمزيد من المعلومات. |
| dataset_type | مفتاح نوع مجموعة البيانات المستخدمة |
| sortables | المفاتيح التي يمكن استخدامها لفرز أنواع مجموعات البيانات المستخدمة حسب الجذع المحدد بترتيب تسلسلي. |
| sort | مفتاح الفرز المستخدم من فئة sortable. |
لإنشاء إدخال في "Quality Checker"، عليك إرسال طلب POST إلى الرابط التالي:
https://mvsep.com/api/quality_checker/add
| حقل | نوع | وصف |
|---|---|---|
| api_token | سلسلة | (مطلوب) مفتاح واجهة التطبيق الخاصة بك |
| zipfile | ثنائي | (مطلوب) ملف مضغوط جاهز للمعالجة |
| algo_name | سلسلة | (مطلوب) اسم الخوارزمية |
| main_text | سلسلة | (مطلوب) وصف الخوارزمية |
| dataset_type | سلسلة | نوع مجموعة البيانات. القيمة الافتراضية هي 0.
|
| password | سلسلة | (مطلوب) خوارزمية حذف كلمة المرور |
| ensemble | عدد صحيح | 0 - الخوارزمية ليست مجموعة. 1 - الخوارزمية هي مجموعة. |
curl --location 'https://mvsep.com/api/quality_checker/add' --form 'zipfile=@"/path/to/zipfile"' --form 'algo_name="Test Algorithm Name"' --form 'main_text="Test Algorithm Description"' --form 'dataset_type="2"' --form 'ensemble="1"' --form 'password="test"'
| المفتاح | القيمة |
|---|---|
| success |
|
| data | يحتوي على معلومات حول الإدخال |
| data -> id | رقم التعريف للمدخلة |
| data -> link | رابط المقالة |
تستخدم واجهة برمجة التطبيقات MVSEP الأكواد الخطأ التالية:
| رمز الخطأ | المعنى |
|---|---|
| 400 | النموذج غير صالح |
| 401 |
api_token غير معروف أو غير صالح. يظهر هذا الخطأ إذا استخدمت مفتاح واجهة برمجة التطبيقات غير معروف
|
للحصول على معلومات حول إدخال قائمة انتظار "Quality Checker" باستخدام المعرف، عليك إجراء استدعاء GET إلى الرابط التالي:
https://mvsep.com/api/quality_checker/entry
| حقل | نوع | وصف |
|---|---|---|
| id | عدد صحيح | (مطلوب) رقم التعريف للمدخلة |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
لحذف إدخال من قائمة انتظار "Quality Checker" باستخدام المعرف وكلمة المرور، عليك إجراء استدعاء GET إلى الرابط التالي:
https://mvsep.com/api/quality_checker/delete
| حقل | نوع | وصف |
|---|---|---|
| id | عدد صحيح | (مطلوب) رقم التعريف للمدخلة |
| password | سلسلة | (مطلوب) كلمة المرور المستخدمة للدخول |
curl --location 'https://mvsep.com/api/quality_checker/delete' --form 'id="7720"' --form 'password="test"'
| المفتاح | القيمة |
|---|---|
| success |
|
| data->message | يُظهر ما إذا كان الإدخال قد تم حذفه |
turbo@mvsep.com