turbo@mvsep.com
توفر واجهة برمجة التطبيقات MVSEP وصولًا برمجيًا لإنشاء فصل، إرجاع النتائج، الحصول على معلومات الموقع والتحكم في قدرات المستخدم.
لاستخدام هذه الواجهة، تحتاج إلى مفتاح API. أنت غير مسجل الدخول، يرجى تسجيل الدخول للحصول على رمز API الخاص بك.
يرجى ملاحظة أن مستخدمي الإصدار المميز يمكنهم طلب عدد غير محدود من المهام المتزامنة، بينما لا يمكن لمستخدمي الإصدار العادي طلب سوى مهمة متزامنة واحدة.
تدير MVSEP نقاط نهاية API إقليمية. وتشترك جميع المناطق في قاعدة بيانات حسابات واحدة، لذا فإن الحساب نفسه ومفتاح API وتجزئات المهام تعمل في كل مكان:
https://de.mvsep.com/apihttps://de2.mvsep.com/apihttps://hk.mvsep.com/apiيتم توجيه الطلبات المرسلة إلى https://mvsep.com/api جغرافيًّا إلى المنطقة الأقرب إلى المتصل. بالنسبة لعمليات تكامل واجهة برمجة التطبيقات (API)، نوصي بالاتصال بنقطة نهاية إقليمية بشكل صريح — فهذا يحافظ على بقاء دورة حياة المهمة بأكملها على مضيف واحد بغض النظر عن المكان الذي تنشأ منه طلباتك.
تتم معالجة كل عملية فصل وتخزينها في المنطقة التي تم إنشاؤها فيها، وتشير عناوين URL للتنزيل التي يتم إرجاعها في الردود دائمًا إلى مضيف تلك المنطقة. للحصول على أفضل أداء، اختر نقطة النهاية الأقرب إلى خوادمك واستخدم نفس المضيف طوال دورة حياة المهمة بأكملها — من الإنشاء، إلى الاستعلام عن الحالة، وصولاً إلى تنزيل الملفات.
يمكنك الاستعلام عن حالة أي مهمة من أي منطقة (حيث إن قاعدة البيانات مشتركة)، لكن ملفات الإخراج نفسها يتم توفيرها دائمًا من قبل المنطقة التي تمتلك المهمة.
لإنشاء فصل، تحتاج إلى إجراء استدعاء 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)) |
| preset_id | عدد صحيح | (اختياري) قم بتطبيق إحدى الإعدادات المسبقة المحفوظة على الملف بدلاً من خوارزمية واحدة. أدخل إما sep_type أو preset_id — حيث تحدد الإعدادات المسبقة خوارزمياتها وخياراتها وتنسيقات الإخراج الخاصة بها، لذا يتم تجاهل sep_type، وحقول add_opt، وoutput_format جميعها معها. تُرجع الاستجابة هاشًا يمكنك استعلامه تمامًا مثل عملية الفصل؛ وتحتوي النتيجة على إدخال واحد لكل عقدة إخراج في الإعداد المسبق. راجع جدول الإعدادات المسبقة أدناه لمعرفة معرّفاتك. |
| 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 الخيارات:
المفتاح: add_opt3 الاسم: Set of stems الخيارات:
|
| 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 Vibraphone | 129 | |
| MVSep Metal Bars | 130 | |
| MVSep Rhodes | 131 | |
| 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 Whistle | 132 | |
| 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 Clap | 133 | |
| MVSep Cowbell | 128 | |
| 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
تُرجع نفس نقطة النهاية عمليات التشغيل المُعدة مسبقًا: استعلم عن التجزئة التي حصلت عليها من preset_id تمامًا كما تفعل مع عملية الفصل. الغلاف متطابق — status ينتقل عبر waiting و processing إلى done — وdata.type هو preset_run. كل إدخال في data.files يمثل عقدة إخراج واحدة من الإعداد المسبق، ويتم تسميتها حسب تسميتها بدلاً من الجذع. لا تكون عملية التشغيل مرئية إلا للحساب الذي أنشأها.
| حقل | نوع | وصف |
|---|---|---|
| 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) |
Delete one of your own separations — a regular job or a preset run. This removes the record and its output files. A separation that is still processing must be cancelled first. Deleting does not refund credits, since the work has already run.
POST https://mvsep.com/api/separation/delete
يمكنك الاستعلام عن حالة أي مهمة من أي منطقة (حيث إن قاعدة البيانات مشتركة)، لكن ملفات الإخراج نفسها يتم توفيرها دائمًا من قبل المنطقة التي تمتلك المهمة.
| حقل | نوع | وصف |
|---|---|---|
| hash | سلسلة | الهاش الخاص بالفصل |
| api_token | سلسلة | API key of the user. Required. |
curl --location --request POST 'https://mvsep.com/api/separation/delete'
--form 'api_token="<رمز API الخاص بك>"'
--form 'hash="20230327071601-0e3e5c6c85-13-dimensions.mp3"'
| المفتاح | القيمة |
|---|---|
| success |
|
| data -> message | يعرض وصف الحالة (يتم عرضه في جميع الحالات، يعرض سبب الخطأ عندما يكون status هو failed) |
للحصول على نتيجة مهمة تُنفَّذ عن بُعد، عليك إجراء استدعاء 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 للحصول على معلومات حول المعلمات المعادة) |
لتسجيل المستخدم في موقع 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 | النموذج غير صالح |
للمصادقة على المستخدم والحصول على مفتاح 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 | تم إدخال بيانات اعتماد غير صحيحة |
للحصول على معلومات المستخدم، يجب إرسال طلب 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 غير صالح |
للحصول على عمليات الشراء بالائتمان الخاصة بهذا الحساب، مرتبة حسب الأحدث أولاً، قم بإجراء استدعاء GET إلى الرابط التالي:
https://mvsep.com/api/purchases
| حقل | نوع | وصف |
|---|---|---|
| api_token | سلسلة | مفتاح API الخاص بالمستخدم |
| limit | عدد صحيح | (اختياري) عدد عمليات الشراء المراد إرجاعها، من 1 إلى 100. القيمة الافتراضية هي 20. |
| offset | عدد صحيح | (اختياري) عدد عمليات الشراء التي سيتم تخطيها، من أجل تصفح سجل الشراء. القيمة الافتراضية هي 0. |
| status | سلسلة | (اختياري) إرجاع عمليات الشراء في هذه الحالة فقط، على سبيل المثال نجحت. تجاهله (أو مرر all) للحصول على كل ما تعرضه صفحة السجل الخاصة بالموقع الإلكتروني، والتي تتضمن عمليات الدفع التي بدأت ولم تكتمل أبدًا — وتكون حالة هذه العمليات unpaid ولا تُمنح أي أرصدة. |
curl --location --request GET 'https://mvsep.com/api/purchases?api_token=<رمز API الخاص بك>&status=succeeded&limit=20'
| المفتاح | القيمة |
|---|---|
| purchases | إدخال واحد لكل عملية شراء: payment_id، status، amount، credits الممنوحة، طريقة الدفع (stripe، paddle، yookassa، google_play أو app_store) والتاريخ. |
| total | ما هو إجمالي عدد عمليات الشراء المتطابقة، مع تجاهل الحد والإزاحة — استخدم هذا الرقم لتقسيم الصفحات. |
| credits | الرصيد الدائن الحالي للحساب. |
تقوم خدمة MVSEP بإرسال بريد إلكتروني إليك عندما ينخفض رصيدك الائتماني إلى الحد الأدنى الذي تختاره، حتى لا يتوقف التشغيل التلقائي بشكل غير متوقع. GET تعرض الإعداد الحالي؛ POST تقوم بتغييره. يتم إرسال التنبيه مرة واحدة ولا يتكرر حتى يرتفع الرصيد مرة أخرى فوق الحد الأدنى.
GET https://mvsep.com/api/credit_alert
POST https://mvsep.com/api/credit_alert
| حقل | نوع | وصف |
|---|---|---|
| api_token | سلسلة | مفتاح API الخاص بالمستخدم |
| credit_threshold | عدد صحيح | (للنشر فقط، إلزامي) أرسل التنبيه بمجرد وصول الرصيد إلى هذا العدد من النقاط أو أقل منه. 0 يؤدي إلى إيقاف التنبيه. يؤدي تغيير الحد الأدنى إلى إعادة تفعيل التنبيه الذي تم إرساله بالفعل. |
curl --location --request GET 'https://mvsep.com/api/credit_alert?api_token=<رمز API الخاص بك>'
curl --location --request POST 'https://mvsep.com/api/credit_alert' --form 'api_token=<رمز API الخاص بك>' --form 'credit_threshold=100'
| المفتاح | القيمة |
|---|---|
| credit_threshold | الحد الأدنى المحدد حالياً، بالوحدات الائتمانية. |
| enabled | <code>true</code> عند تعيين عتبة أكبر من الصفر، وإلا فإنها تكون <code>false</code>. |
| credits | الرصيد الدائن الحالي للحساب. |
| notified | <code>true</code> بمجرد إرسال التنبيه الخاص بالانخفاض الحالي؛ ويتم إلغاء التنبيه تلقائيًا عندما يرتفع الرصيد مرة أخرى فوق الحد المحدد. |
| العنوان الذي يتم إرسال التنبيه إليه. |
لتمكين الاستخدام المتميز للمستخدم، يجب إرسال طلب 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 | يُظهر ما إذا كان الإدخال قد تم حذفه |
المكتبات والتطبيقات وعمليات التكامل المبنية على واجهة برمجة التطبيقات (API) هذه. ما لم يُذكر خلاف ذلك، فإن هذه المشاريع هي مشاريع مجتمعية: لا تتولى MVSEP صيانتها، ولا يمكننا ضمان جودتها.
يتم توزيع هذا البرنامج على PyPI تحت الاسم mvsep-cli، ويُذكر أن MVSEP هو مؤلفه، مما قد يجعله يبدو رسميًا. إلا أنه يتم نشره وصيانته من قِبل طرف ثالث، وليس من قِبل MVSEP، كما أن مستودع الكود المصدري الذي يشير إليه غير موجود. ويطلب منك إدخال رمز API الخاص بك، لذا يرجى قراءة كوده المصدري قبل لصق الرمز فيه.
mvsep-cli: pypi.org/project/mvsep-cli
turbo@mvsep.com