turbo@mvsep.com
Die MVSEP-API bietet programmatischen Zugang zur Erstellung einer Trennung, zum Abrufen der Ergebnisse, zur Informationsabfrage über die Website und zur Kontrolle der Benutzerberechtigungen.
Um diese API nutzen zu können, benötigen Sie einen API-Schlüssel. Sie sind nicht eingeloggt, bitte loggen Sie sich ein, um Ihr API-Token zu erhalten.
Beispiele in Python: https://github.com/ZFTurbo/MVSep-API-Examples
Inoffizielle Anwendung MacVSep für Mac O: https://github.com/septcoco/macvsep
Webhooks können hier eingerichtet werden.: Webhooks-Seite
OpenAPI-Spezifikation: mvsep-openapi-spec.json
Premium-Nutzer können unbegrenzt viele gleichzeitige Aufträge anfordern, während Nicht-Premium-Nutzer nur 1 gleichzeitigen Auftrag anfordern können.
Um eine Trennung zu erstellen, müssen Sie einen POST-Aufruf an die folgende URL tätigen:
https://mvsep.com/api/separation/create
| Feld | Typ | Beschreibung |
|---|---|---|
| api_token | String | Ihr API-Schlüssel |
| audiofile | Binär | Zu verarbeitende Audiodatei. Nicht erforderlich, wenn der Parameter `url` gesetzt ist oder das Modell keine Dateieingabe verwendet. Verwenden Sie für Matcher-Modelle `target_audiofile` und `reference_audiofile` als Eingabe anstelle von `audiofile`. |
| url | String | Link zur Audiodatei. Nicht erforderlich, wenn der Parameter audiofile gesetzt ist |
| remote_type | String | (optional) Dateityp der Audiodatei. Standardmäßig direct. Nicht erforderlich, wenn der Parameter audiofile gesetzt ist. Unterstützte Dateitypen sind direct (Direkter Download), mega (MEGA), drive (Google Drive) und dropbox (Dropbox). |
| sep_type | Integer | Separation Type, standardmäßig 11 (Demucs3 Model B (Gesang, Schlagzeug, Bass, andere)) |
| add_opt1 | String | Erstes zusätzliches Feld für den Trennungstyp |
| add_opt2 | String | Zweites zusätzliches Feld „Trennungstyp“. |
| add_opt3 | String | (optional) Trennungsart drittes zusätzliches Feld |
| output_format | Integer | Ausgabeformat, standardmäßig 0 (mp3 (320 kbps)) |
| is_demo | Boolean | Sollte die Trennung auf der Demoseite veröffentlicht werden, ist der Standardwert „false“. |
| Name | Wert | Zusätzliche Felde |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | Schlüssel: add_opt1 Name: Output files Optionen:
Schlüssel: add_opt2 Name: Model Type Optionen:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | Schlüssel: add_opt1 Name: Output files Optionen:
Schlüssel: add_opt2 Name: Model Type Optionen:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | Schlüssel: add_opt1 Name: Output files Optionen:
Schlüssel: add_opt2 Name: Model Type Optionen:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| Demucs4 HT (vocals, drums, bass, other) | 20 | Schlüssel: add_opt1 Name: Model type Optionen:
|
| BS Roformer (vocals, instrumental) | 40 | Schlüssel: add_opt1 Name: Vocal model type Optionen:
|
| BS PolarFormer (vocals, instrumental) | 123 | Schlüssel: add_opt1 Name: Overlap Optionen:
|
| MelBand Roformer (vocals, instrumental) | 48 | Schlüssel: add_opt1 Name: Vocal model type Optionen:
|
| MDX23C (vocals, instrumental) | 25 | Schlüssel: add_opt1 Name: Vocal model type Optionen:
|
| SCNet (vocals, instrumental) | 46 | Schlüssel: add_opt1 Name: Vocal model type Optionen:
|
| MDX B (vocals, instrumental) | 23 | Schlüssel: add_opt1 Name: Vocal model type Optionen:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | Schlüssel: add_opt1 Name: Model Type Optionen:
Schlüssel: add_opt2 Name: Agressiveness Optionen:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MVSep Karaoke (lead/back vocals) | 49 | Schlüssel: add_opt1 Name: Karaoke model type Optionen:
Schlüssel: add_opt2 Name: Extraction type Optionen:
|
| MDX-B Karaoke (lead/back vocals) | 12 | Schlüssel: add_opt1 Name: Karaoke model type Optionen:
|
| MVSep Crowd removal (crowd, other) | 34 | Schlüssel: add_opt1 Name: Model type Optionen:
|
| Medley Vox (Multi-singer separation) | 53 | Schlüssel: add_opt1 Name: Model type Optionen:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | Schlüssel: add_opt1 Name: Model Type Optionen:
|
| MVSep Male/Female separation | 57 | Schlüssel: add_opt1 Name: Model type Optionen:
Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep Choir (choir, other) | 112 | Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep SATB Choir (soprano, alto, tenor, bass) | 111 | Schlüssel: add_opt1 Name: Model type Optionen:
Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep Drums (drums, other) | 44 | Schlüssel: add_opt1 Name: Drums model type Optionen:
Schlüssel: add_opt2 Name: How to extract Optionen:
Schlüssel: add_opt3 Name: Output files Optionen:
|
| MVSep Bass (bass, other) | 41 | Schlüssel: add_opt1 Name: Bass model type Optionen:
Schlüssel: add_opt2 Name: How to extract Optionen:
Schlüssel: add_opt3 Name: Output files Optionen:
|
| MVSep Synth (synth, other) | 88 | Schlüssel: add_opt1 Name: How to extract Optionen:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | Schlüssel: add_opt1 Name: Model Type Optionen:
Schlüssel: add_opt2 Name: Preprocess Optionen:
|
| MVSep Piano (piano, other) | 29 | Schlüssel: add_opt1 Name: Piano model type Optionen:
|
| MVSep Digital Piano (digital-piano, other) | 79 | Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep Keys (keys, other) | 106 | |
| MVSep Organ (organ, other) | 58 | Schlüssel: add_opt1 Name: Organ model type Optionen:
|
| MVSep Harpsichord (harpsichord, other) | 91 | |
| MVSep Accordion (accordion, other) | 99 | |
| MVSep Guitar (guitar, other) | 31 | Schlüssel: add_opt1 Name: Guitar model type Optionen:
|
| MVSep Acoustic Guitar (acoustic-guitar, other) | 66 | Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep Electric Guitar (electric-guitar, other) | 81 | Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep Lead/Rhythm Guitar (lead-guitar, rhythm-guitar) | 101 | Schlüssel: add_opt1 Name: Model type Optionen:
|
| 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 | Schlüssel: add_opt1 Name: String model type Optionen:
Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep Violin (violin, other) | 65 | |
| MVSep Viola (viola, other) | 69 | Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep Cello (cello, other) | 70 | Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep Double Bass (double-bass, other) | 73 | Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep Wind (wind, other) | 54 | Schlüssel: add_opt1 Name: Wind model type Optionen:
Schlüssel: add_opt2 Name: How to extract Optionen:
Schlüssel: add_opt3 Name: Output files Optionen:
|
| MVSep Brass (brass, other) | 107 | Schlüssel: add_opt1 Name: How to extract Optionen:
|
| MVSep Woodwind (woodwind, other) | 108 | Schlüssel: add_opt1 Name: How to extract Optionen:
|
| MVSep Saxophone (saxophone, other) | 61 | Schlüssel: add_opt1 Name: Model type Optionen:
|
| MVSep Flute (flute, other) | 67 | Schlüssel: add_opt1 Name: Flute model type Optionen:
Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep Trumpet (trumpet, other) | 71 | Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep Trombone (trombone, other) | 75 | Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep Oboe (oboe, other) | 77 | Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep Clarinet (clarinet, other) | 78 | Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep French Horn (french-horn, other) | 82 | Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep Harmonica (harmonica, other) | 87 | Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep Tuba (tuba, other) | 92 | |
| MVSep Bassoon (bassoon, other) | 93 | |
| MVSep Bagpipes (bagpipes , other) | 116 | Schlüssel: add_opt2 Name: How to extract Optionen:
|
| 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 | Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep Celesta (celesta, other) | 110 | Schlüssel: add_opt2 Name: How to extract Optionen:
|
| MVSep Demucs4HT DNR (speech, music, effects) | 24 | Schlüssel: add_opt1 Name: Model type Optionen:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | Schlüssel: add_opt1 Name: Model Type Optionen:
|
| MVSep DnR v3 (speech, music, effects) | 56 | Schlüssel: add_opt1 Name: Model type Optionen:
Schlüssel: add_opt2 Name: How to extract Optionen:
Schlüssel: add_opt3 Name: Output files Optionen:
|
| MVSep Braam (braam , other) | 117 | |
| MVSep FX (fx, other) | 122 | |
| Apollo Enhancers (by JusperLee, Lew, baicai1145) | 51 | Schlüssel: add_opt1 Name: Model type Optionen:
Schlüssel: add_opt2 Name: Cutoff (Hz) Optionen:
|
| Reverb Removal (noreverb) | 22 | Schlüssel: add_opt1 Name: Model Type Optionen:
Schlüssel: add_opt2 Name: Preprocess Optionen:
|
| DeNoise by aufr33 and gabox | 47 | Schlüssel: add_opt1 Name: Model type Optionen:
|
| AudioSR (Super Resolution) | 59 | Schlüssel: add_opt1 Name: Cutoff (Hz) Optionen:
|
| FlashSR (Super Resolution) | 60 | |
| Stable Audio Open Gen | 62 | Schlüssel: add_opt1 Name: Text prompt Optionen: Schlüssel: add_opt2 Name: Length (in seconds) Optionen:
|
| Whisper (extract text from audio) | 39 | Schlüssel: add_opt1 Name: Model type Optionen:
Schlüssel: add_opt2 Name: Transcription type Optionen:
|
| Parakeet (extract text from audio) | 64 | Schlüssel: add_opt1 Name: Model type Optionen:
Schlüssel: add_opt2 Name: Version Optionen:
|
| VibeVoice (Voice Cloning) | 103 | Schlüssel: add_opt1 Name: Model type Optionen:
Schlüssel: add_opt2 Name: Text prompt Optionen: Schlüssel: add_opt3 Name: Extract vocals first Optionen:
|
| VibeVoice (TTS) | 104 | Schlüssel: add_opt1 Name: Model type Optionen:
Schlüssel: add_opt2 Name: Text prompt Optionen: |
| Qwen3-TTS (Custom Voice) | 118 | Schlüssel: add_opt1 Name: Text prompt Optionen: Schlüssel: add_opt2 Name: Speaker Optionen:
Schlüssel: add_opt3 Name: Language Optionen:
Schlüssel: add_opt4 Name: Voice description Optionen: |
| Qwen3-TTS (Voice Design) | 119 | Schlüssel: add_opt1 Name: Text prompt Optionen: Schlüssel: add_opt2 Name: Voice description Optionen: Schlüssel: add_opt3 Name: Language Optionen:
|
| Qwen3-TTS (Voice Cloning) | 120 | Schlüssel: add_opt1 Name: Text prompt Optionen: Schlüssel: add_opt2 Name: Reference text in audio (optional) Optionen: Schlüssel: add_opt3 Name: Language Optionen:
Schlüssel: add_opt4 Name: Extract vocals first Optionen:
|
| Bark (Speech Gen) | 115 | Schlüssel: add_opt1 Name: Text prompt Optionen: Schlüssel: add_opt2 Name: Speaker Optionen:
|
| MVSep MultiSpeaker (MDX23C) | 42 | Schlüssel: add_opt1 Name: Model Type Optionen:
|
| Aspiration (by Sucial) | 50 | Schlüssel: add_opt1 Name: Model type Optionen:
|
| Phantom Centre extraction | 55 | Schlüssel: add_opt1 Name: Model type Optionen:
|
| Matchering (by sergree) | 68 | |
| SOME (Singing-Oriented MIDI Extractor) | 80 | Schlüssel: add_opt1 Name: How to use Optionen:
|
| Transkun (piano -> midi) | 113 | Schlüssel: add_opt1 Name: How to extract Optionen:
|
| Basic Pitch (MIDI Extraction) | 114 | |
| HeartMuLa (Song Gen) | 121 | Schlüssel: add_opt1 Name: Lyrics Optionen: Schlüssel: add_opt10 Name: Topic Optionen:
Schlüssel: add_opt2 Name: Tags (optional) Optionen: Schlüssel: add_opt3 Name: Genre Optionen:
Schlüssel: add_opt4 Name: Timbre Optionen:
Schlüssel: add_opt5 Name: Gender Optionen:
Schlüssel: add_opt6 Name: Mood Optionen:
Schlüssel: add_opt7 Name: Instrument Optionen:
Schlüssel: add_opt8 Name: Scene Optionen:
Schlüssel: add_opt9 Name: Region Optionen:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | Schlüssel: add_opt1 Name: Model type Optionen:
|
| MDX A/B (vocals, drums, bass, other) | 7 | Schlüssel: add_opt1 Name: Vocal model type Optionen:
|
| Vit Large 23 (vocals, instrum) | 33 | Schlüssel: add_opt1 Name: Model type Optionen:
|
| UVRv5 Demucs (vocals, music) | 17 | Schlüssel: add_opt1 Name: Model Type Optionen:
|
| 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 | Schlüssel: add_opt1 Name: Model type Optionen:
|
| UnMix | 3 | Schlüssel: add_opt1 Name: Model type Optionen:
|
| Zero Shot (Query Based) (Low quality) | 14 | Schlüssel: add_opt1 Name: Model Type Optionen:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | Schlüssel: add_opt1 Name: Model type Optionen:
|
| Name | Wert |
|---|---|
| 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="<Ihr API-Token>"'
--form 'sep_type="9"'
--form 'add_opt1="0"'
--form 'add_opt2="1"'
--form 'output_format="1"'
--form 'is_demo="1"'
| Schlüssel | Wert |
|---|---|
| success |
|
| data | Hält zusätzliche Informationen abhängig vom success-Schlüssel |
| data -> link | Zeigt einen Link zur "GET RESULT"-URL des erstellten Jobs an (nur angezeigt, wenn success true ist) |
| data -> hash | Zeigt den Hash des erstellten Jobs an (nur angezeigt, wenn success true ist) |
| data -> message | Zeigt die Beschreibung eines Fehlers an (nur angezeigt, wenn success false ist) |
Die MVSEP-API verwendet die folgenden Fehlercodes:
| Fehlercode | Bedeutung |
|---|---|
| 400 | Einige Parameter fehlen oder sind ungültig. Dieser Fehler tritt auf, wenn Sie nicht alle obligatorischen Parameter oder ungültige Parameter übergeben. |
| 401 |
Unbekannter oder ungültiger api_token. Dieser Fehler erscheint, wenn Sie einen unbekannten API-Schlüssel verwenden
|
Um das Trennungsergebnis zu erhalten, müssen Sie einen GET-Aufruf an die folgende URL durchführen:
https://mvsep.com/api/separation/get
| Feld | Typ | Beschreibung |
|---|---|---|
| hash | String | Trennungs-Hash |
| mirror | Integer | (optional) Verwendet einen anderen Mirror, wenn auf 1 gesetzt, standardmäßig 0. Erfordert api_token und 1 Kredit, wenn auf 1 gesetzt. |
| api_token | String | (optional) API-Schlüssel des Benutzers. Erforderlich, wenn der Mirror-Parameter auf 1 gesetzt ist. |
curl --location --request GET 'https://mvsep.com/api/separation/get?hash=20230327071601-0e3e5c6c85-13-dimensions.mp3'
| Schlüssel | Wert |
|---|---|
| success |
|
| status |
|
| data | Hält zusätzliche Informationen je nach dem status-Schlüssel |
| data -> queue_count | Zeigt die Anzahl der nicht verarbeiteten Jobs in der Benutzerpriorität an (wird nur angezeigt, wenn der status auf waiting oder distributing gesetzt ist) |
| data -> current_order | Zeigt die Reihenfolge des Benutzerjobs an (wird nur angezeigt, wenn der status auf waiting oder distributing gesetzt ist) |
| data -> message | Zeigt die Beschreibung des Status an (wird bei allen Status angezeigt, zeigt stattdessen den Fehlergrund an, wenn der status auf failed gesetzt ist) |
| data -> algorithm | Zeigt den verwendeten Algorithmus für den Job an (wird nur angezeigt, wenn der status auf done gesetzt ist) |
| data -> algorithm_description | Zeigt die Details des verwendeten Algorithmus für den Job an (wird nur angezeigt, wenn der status auf done gesetzt ist) |
| data -> output_format | Zeigt das Ausgabeformat des Jobs an (wird nur angezeigt, wenn der status auf done gesetzt ist) |
| data -> tags | Zeigt die Audio-Meta-Tags an (wird nur angezeigt, wenn der status auf done gesetzt ist) |
| data -> input_file | Zeigt die Details zum Download der Eingabe-Audiodatei an (wird nur angezeigt, wenn der status auf done gesetzt ist) |
| data -> files | Zeigt die Details zum Download der Ausgabedateien an (wird nur angezeigt, wenn der status auf done gesetzt ist) |
| data -> date | Zeigt das Verarbeitungsdatum des Jobs an (wird nur angezeigt, wenn der status auf done gesetzt ist) |
| data -> finished_chunks | Zeigt die Anzahl der fertigen Teile eines großen Jobs an (wird nur angezeigt, wenn der status auf distributing gesetzt ist) |
| data -> all_chunks | Zeigt die Gesamtzahl der Teile eines großen Jobs an (wird nur angezeigt, wenn der status auf distributing gesetzt ist) |
Um das Ergebnis eines Remote-Jobs zu erhalten, müssen Sie einen GET-Aufruf an die folgende URL durchführen:
https://mvsep.com/api/separation/get-remote
| Feld | Typ | Beschreibung |
|---|---|---|
| hash | String | Trennungs-Hash |
curl --location --request GET 'https://mvsep.com/api/separation/get-remote?hash=n2AwBjy4KsFZfqqR'
| Schlüssel | Wert |
|---|---|
| success |
|
| status |
|
| data | Hält zusätzliche Informationen je nach dem status-Schlüssel |
| data -> queue_count | Zeigt die Anzahl der noch nicht bearbeiteten Aufträge in Abhängigkeit von der Priorität des Benutzers an (wird nur angezeigt, wenn status waiting ist). |
| data -> current_order | Zeigt die Reihenfolge der Aufgaben des Benutzers an (wird nur angezeigt, wenn status waiting ist) |
| data -> message | Zeigt die Statusbeschreibung an (nur wenn status fehlgeschlagen ist). |
| data -> link | Zeigt einen Link zur "GET RESULT"-URL des erstellten Auftrags an (wird nur angezeigt, wenn status done ist) |
| data -> hash | Hash der Trennung (wird nur angezeigt, wenn status done ist) |
Um die Trennung zu stornieren und die verwendeten Guthaben zurückzuerstatten (sofern die Trennung noch nicht bearbeitet wird), müssen Sie einen POST-Aufruf an die folgende URL senden:
https://mvsep.com/api/separation/cancel
| Feld | Typ | Beschreibung |
|---|---|---|
| api_token | String | API-Schlüssel des Benutzers |
| hash | String | Trennungs-Hash |
curl --location --request POST 'https://mvsep.com/api/separation/cancel' --form 'api_token="<Ihr API-Token>"' --form 'hash="<hash>"'
| Schlüssel | Wert |
|---|---|
| success |
|
Um detaillierte Daten über Trennungstypen zu erhalten, müssen Sie einen GET-Aufruf an die folgende URL machen:
https://mvsep.com/api/app/algorithms
| Feld | Typ | Beschreibung |
|---|---|---|
| scopes | String | Ob Modelle einbezogen werden sollen, die unterschiedliche Eingabeformen verwenden.
single_upload verwendet, falls nicht anders angegeben. Um alle Modelle zu erhalten, setzen Sie scopes=single_upload,no_upload,matchering_upload.
|
curl --location --request GET 'https://mvsep.com/api/app/algorithms'
Gibt die Daten als Array zurück:
| Schlüssel | Wert |
|---|---|
| render_id | Wert des Trennungstyps (ID) |
| name | Name des Trennungstyps |
| algorithm_group_id | Die Gruppe, zu der der Trennungstyp gehört: |
| algorithm_group | Enthält Informationen über die Algorithmengruppe, zu der der Algorithmus gehört. |
| algorithm_group -> name | Name der Algorithmengruppe. |
| audio_widget |
Der Typ des Audio-Widgets, der für den Algorithmus verwendet werden soll. Damit lässt sich festlegen, wie der Audioplayer für den Algorithmus im Frontend angezeigt wird. Mögliche Werte sind:
|
| orientation |
Für wen dieser Trennungstyp bestimmt ist:
|
| order_id | Die Reihenfolge des Trennungstyps |
| price_coefficient |
Wird verwendet, um zu berechnen, wie viele Credits ein Job von einem Premium-Benutzer verbraucht. Verwendet diese Formel: : floor(<Dauer der Audiodatei in Sekunden> * price_coefficient / 60)?:1
|
| usage | Zeigt die monatliche Nutzungshäufigkeit des Trenntyps an |
| rating | Zeigt die monatliche Nutzungsrate des Trennungstyps als Array an:
|
| algorithm_fields | Enthält Informationen zu zusätzlichen Feldern des Trennungstyps |
| algorithm_fields -> name |
Zeigt welches zusätzliche Feld des Trennungstyps:
|
| algorithm_fields -> text | Anzeigename des zusätzlichen Feldes des Trennungstyps. |
| algorithm_fields -> options | JSON-codierte Schlüssel-Wert-Paare des zusätzlichen Feldes |
| algorithm_fields -> default_key | Standardwert des zusätzlichen Feldes. Einer der Schlüssel von <code>algorithm_fields -> options</code> |
| algorithm_descriptions | Enthält Informationen über die Beschreibungen des Trennungstyps |
| algorithm_descriptions -> short_description | Kurze Beschreibung des Trennungstyps, die kein HTML verwendet. |
| algorithm_descriptions -> long_description | Detaillierte Beschreibung des Trennungstyps, die HTML verwendet. |
| algorithm_descriptions -> lang | Festgelegter Sprachcode der Beschreibung. |
Um Informationen über die neuesten Nachrichten zu MVSEP zu erhalten, müssen Sie einen GET-Aufruf an die folgende URL machen:
https://mvsep.com/api/app/news
| Feld | Typ | Beschreibung |
|---|---|---|
| lang | String | (optional) 2-Buchstaben-Sprachcode (en, ru) |
| start | Integer | (optional) Startpunkt-Offset, standardmäßig 0 (d. h. Start bei den neuesten) |
| limit | Integer | (optional) Maximale Anzahl der zurückgegebenen Ergebnisse, standardmäßig 10, maximal 20. |
curl --location --request GET 'https://mvsep.com/api/app/news?lang=en&start=2&limit=1'
Gibt die Daten als Array zurück:
| Schlüssel | Wert |
|---|---|
| title | Titel der Nachricht |
| lang | Titel der Nachricht |
| text | Vollständige Beschreibung der Nachricht |
| created_at | Datum der Nachricht |
Um Informationen zur Website-Warteschlange zu erhalten, müssen Sie einen GET-Aufruf an die folgende URL senden:
https://mvsep.com/api/app/queue
| Feld | Typ | Beschreibung |
|---|---|---|
| api_token | String | (optional) API-Schlüssel des Benutzers |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| Schlüssel | Wert |
|---|---|
| queue |
Enthält ein Array der aktuellen Warteschlangen für verschiedene Tarife:
|
| plan |
Enthält die aktuelle Warteschlange für den aktuellen Tarif (fügen Sie api_token hinzu, um einen registrierten/Premium-Tarif anzufordern):
|
Um Informationen über Demo-Trennungen zu erhalten, müssen Sie einen GET-Aufruf an die folgende URL machen:
https://mvsep.com/api/app/demo
| Feld | Typ | Beschreibung |
|---|---|---|
| start | Integer | (optional) Startpunkt-Offset, standardmäßig 0 (d. h. Start bei den neuesten) |
| limit | Integer | (optional) Maximale Anzahl der zurückgegebenen Ergebnisse, standardmäßig 10, maximal 20. |
| algorithm_id | Integer | Optionale Trenntyp-ID. Verwenden Sie diese, um Demotrennungen zurückzugeben, die nur von einem Algorithmus erstellt wurden. Die Werte entsprechen render_id des Endpunkts GET SEPARATION TYPES. |
| options[FIELD] | String / Integer | Optionaler Filter für Algorithmusoptionswerte. Ersetzen Sie FIELD durch einen zusätzlichen Feldschlüssel aus algorithm_fields -> name in der GET SEPARATION TYPES-Antwort und übergeben Sie anschließend einen der options-Schlüssel dieses Felds als Wert. Beispiel: options[vocals]=1. |
| additional_options | String | Optionale Rohdaten enthalten Filter für gespeicherte Joboptionsdaten. Verwenden Sie für neue Integrationen bevorzugt options[FIELD], da dies explizit und einfacher zu kombinieren ist. |
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'
Um Optionsfilter zu erstellen, rufen Sie zunächst https://mvsep.com/api/app/algorithms auf und inspizieren Sie die Liste algorithm_fields jedes Algorithmus. Verwenden Sie das Feld name innerhalb von options[FIELD] und setzen Sie einen der JSON-Optionsschlüssel als Wert ein.
Gibt die Daten als Array zurück:
| Schlüssel | Wert |
|---|---|
| hash | Trennungs-Hash |
| date | Datum der Trennung |
| input_audio | Input-Audio-URL |
| size | Input-Audio-Größe |
| algorithm | Enthält grundlegende Informationen über den verwendeten Trennungstyp (siehe den Tab "GET SEPARATION TYPES" für Informationen zu den zurückgegebenen Parametern) |
Um den Benutzer zu authentifizieren und den API-Schlüssel des Benutzers zu erhalten, müssen Sie einen POST-Aufruf an die folgende URL machen:
https://mvsep.com/api/app/login
| Feld | Typ | Beschreibung |
|---|---|---|
| String | Email des Benutzers | |
| password | String | Passwort des Benutzers |
curl --location --request POST 'https://mvsep.com/api/app/login' --form 'email="<Email des Benutzers>"' --form 'password="<Passwort des Benutzers>"'
| Schlüssel | Wert |
|---|---|
| success |
|
| data | Enthält Informationen, wenn die Anmeldedaten gültig sind |
| data -> name | Name des Benutzers |
| data -> email | Email des Benutzers |
| data -> api_token | Der API-Schlüssel des Benutzers. Stellen Sie sicher, dass er in sicherer Speicherung aufbewahrt wird und für nachfolgende Operationen verwendet wird. |
| data -> premium_minutes | Verbleibende Credits des Benutzers |
| data -> premium_enabled |
Ob dem Benutzer die Verwendung von Credits erlaubt ist:
|
| data -> long_filenames_enabled |
Ob der Benutzer zusätzliche Informationen in Dateinamen möchte:
|
Die MVSEP-API verwendet die folgenden Fehlercodes:
| Fehlercode | Bedeutung |
|---|---|
| 400 | Ungültige Anmeldedaten angegeben |
Um einen Benutzer auf der MVSEP-Website zu registrieren, müssen Sie einen POST-Aufruf an die folgende URL machen:
https://mvsep.com/api/app/register
| Feld | Typ | Beschreibung |
|---|---|---|
| name | String | Name des Benutzers |
| String | Email des Benutzers | |
| password | String | Passwort des Benutzers |
| password_confirmation | String | Passwort des Benutzers wiederholen |
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"'
| Schlüssel | Wert |
|---|---|
| success |
|
| message | Tritt auf, wenn das Formular gültig ist |
Die MVSEP-API verwendet die folgenden Fehlercodes:
| Fehlercode | Bedeutung |
|---|---|
| 400 | Formular ist ungültig |
Um Benutzerinformationen zu erhalten, müssen Sie einen GET-Aufruf an die folgende URL machen:
https://mvsep.com/api/app/user
| Feld | Typ | Beschreibung |
|---|---|---|
| api_token | String | API-Schlüssel des Benutzers |
curl --location --request GET 'https://mvsep.com/api/app/user?api_token=<Ihr API-Token>'
| Schlüssel | Wert |
|---|---|
| success |
|
| data | Enthält Informationen, wenn die Anmeldedaten gültig sind |
| data -> name | Name des Benutzers |
| data -> email | Email des Benutzers |
| data -> api_token | Der API-Schlüssel des Benutzers. Stellen Sie sicher, dass er in sicherer Speicherung aufbewahrt wird und für nachfolgende Operationen verwendet wird. |
| data -> premium_minutes | Verbleibende Credits des Benutzers |
| data -> premium_enabled |
Ob dem Benutzer die Verwendung von Credits erlaubt ist:
|
| data -> long_filenames_enabled |
Ob der Benutzer zusätzliche Informationen in Dateinamen möchte:
|
| data -> current_queue | Zeigt laufende Trennungen für den Benutzer an |
Die MVSEP-API verwendet die folgenden Fehlercodes:
| Fehlercode | Bedeutung |
|---|---|
| 400 | Ungültiger API-Schlüssel |
Um grundlegende Informationen zur Trennungshistorie des Benutzers zu erhalten, müssen Sie einen GET-Aufruf an die folgende URL machen:
https://mvsep.com/api/app/separation_history
| Feld | Typ | Beschreibung |
|---|---|---|
| api_token | String | API-Schlüssel des Benutzers |
| start | Integer | (optional) Startpunkt-Offset, standardmäßig 0 (d. h. Start bei den neuesten) |
| limit | Integer | (optional) Maximale Anzahl der zurückgegebenen Ergebnisse, standardmäßig 10, maximal 20. |
curl --location --request GET 'https://mvsep.com/api/app/separation_history?api_token=<Ihr API-Token>&start=1&limit=2'
| Schlüssel | Wert |
|---|---|
| success |
|
| data | Enthält ein Array grundlegender Informationen über frühere Trennungen |
| data -> hash | Trennungs-Hash |
| data -> job_exists | Enthält ein Array grundlegender Informationen über frühere Trennungen |
| data -> credits | Wie viele Credits für den Job verwendet wurden, wenn die Trennung nicht mehr existiert. |
| data -> time_left | Ungefähre verbleibende Zeit, bis der Job gelöscht wird |
| data -> algorithm | Enthält grundlegende Informationen über den verwendeten Trennungstyp (siehe den Tab "GET SEPARATION TYPES" für Informationen zu den zurückgegebenen Parametern) |
Die MVSEP-API verwendet die folgenden Fehlercodes:
| Fehlercode | Bedeutung |
|---|---|
| 400 | Ungültiger API-Schlüssel |
Um die Premium-Nutzung für den Benutzer zu aktivieren, müssen Sie einen POST-Aufruf an die folgende URL machen:
https://mvsep.com/api/app/enable_premium
| Feld | Typ | Beschreibung |
|---|---|---|
| api_token | String | API-Schlüssel des Benutzers |
curl --location --request POST 'https://mvsep.com/api/app/enable_premium' --form 'api_token="<Ihr API-Token>"'
| Schlüssel | Wert |
|---|---|
| success |
|
| message | Informiert über den Status der Operation |
Die MVSEP-API verwendet die folgenden Fehlercodes:
| Fehlercode | Bedeutung |
|---|---|
| 400 | Ungültiger API-Schlüssel |
Um die Premium-Nutzung für den Benutzer zu deaktivieren, müssen Sie einen POST-Aufruf an die folgende URL machen:
https://mvsep.com/api/app/disable_premium
| Feld | Typ | Beschreibung |
|---|---|---|
| api_token | String | API-Schlüssel des Benutzers |
curl --location --request POST 'https://mvsep.com/api/app/disable_premium' --form 'api_token="<Ihr API-Token>"'
| Schlüssel | Wert |
|---|---|
| success |
|
| message | Informiert über den Status der Operation |
Die MVSEP-API verwendet die folgenden Fehlercodes:
| Fehlercode | Bedeutung |
|---|---|
| 400 | Ungültiger API-Schlüssel |
Um lange Dateinamen für den Benutzer zu aktivieren, müssen Sie einen POST-Aufruf an die folgende URL machen:
https://mvsep.com/api/app/enable_long_filenames
| Feld | Typ | Beschreibung |
|---|---|---|
| api_token | String | API-Schlüssel des Benutzers |
curl --location --request POST 'https://mvsep.com/api/app/enable_long_filenames' --form 'api_token="<Ihr API-Token>"'
| Schlüssel | Wert |
|---|---|
| success |
|
| message | Informiert über den Status der Operation |
Die MVSEP-API verwendet die folgenden Fehlercodes:
| Fehlercode | Bedeutung |
|---|---|
| 400 | Ungültiger API-Schlüssel |
Um lange Dateinamen für den Benutzer zu deaktivieren, müssen Sie einen POST-Aufruf an die folgende URL machen:
https://mvsep.com/api/app/disable_long_filenames
| Feld | Typ | Beschreibung |
|---|---|---|
| api_token | String | API-Schlüssel des Benutzers |
curl --location --request POST 'https://mvsep.com/api/app/disable_long_filenames' --form 'api_token="<Ihr API-Token>"'
| Schlüssel | Wert |
|---|---|
| success |
|
| message | Informiert über den Status der Operation |
Die MVSEP-API verwendet die folgenden Fehlercodes:
| Fehlercode | Bedeutung |
|---|---|
| 400 | Ungültiger API-Schlüssel |
Um Informationen über Einträge in der Qualitätsprüfungswarteschlange zu erhalten, müssen Sie einen GET-Aufruf an die folgende URL durchführen:
https://mvsep.com/api/quality_checker/queue
| Feld | Typ | Beschreibung |
|---|---|---|
| start | Integer | (optional) Startpunkt-Offset, standardmäßig 0 (d. h. Start bei den neuesten) |
| limit | Integer | (optional) Maximale Anzahl der zurückgegebenen Ergebnisse, standardmäßig 10, maximal 20. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/queue?&start=1&limit=2'
Gibt die Daten als Array zurück:
| Schlüssel | Wert |
|---|---|
| id | Identifikationsnummer des Eintrags |
| dataset_type | Datensatztyp, der beim Hinzufügen des Eintrags/der Rangliste ausgewählt wurde
|
| date | Erstellungsdatum des Eintrags |
| algo_name | Name des verwendeten Trennverfahrens/Algorithmus |
| main_text | Beschreibung des verwendeten Trennverfahrens/Algorithmus |
| proc | Status der Bearbeitung
|
| proc_remote_date | Zeitstempel des Verarbeitungsdatums |
| msg | Gibt bei Erfolg "OK" zurück, andernfalls wird eine Fehlermeldung angezeigt. |
| metrics | Informationen zu Einstiegsmetriken |
| sdr_* (wildcard) | SDR der entsprechenden Stäm |
| dataset_name | Name des Datensatze |
Um Informationen über die Ranglisten von Quality Checker zu erhalten, müssen Sie einen GET-Aufruf an die folgende URL durchführen
https://mvsep.com/api/quality_checker/leaderboard
| Feld | Typ | Beschreibung |
|---|---|---|
| dataset_type | String | Datensatztyp, standardmäßig 0, falls nicht angegeben.
|
| start | Integer | (optional) Startpunkt-Offset, standardmäßig 0 (d. h. Start bei den neuesten) |
| limit | Integer | (optional) Maximale Anzahl der zurückgegebenen Ergebnisse, standardmäßig 10, maximal 20. |
| algo_name_filter | String | Filtert Trennungstypen/Algorithmusnamen anhand des angegebenen Textes |
| sort | String | Sortieren Sie nach dem angegebenen SDR des Stamms. Sie können eine Liste sortierbarer Werte für einen bestimmten Datensatztyp über den Schlüssel `sortables` in der Antwort abrufen |
curl --location --request GET 'https://mvsep.com/api/quality_checker/leaderboard?&start=1&limit=2&algo_name_filter=MVSep'
| Schlüssel | Wert |
|---|---|
| data | Enthält ein Array von Einträgen des Qualitätsprüfers. Weitere Informationen finden Sie im Abschnitt „GET QUEUE-Antwort des Qualitätsprüfers“ |
| dataset_type | Verwendeter Datensatztypschlüssel |
| sortables | Schlüssel, die verwendet werden können, um den verwendeten Datensatztyp nach einem gegebenen Stamm in sequenzieller Reihenfolge zu sortieren. |
| sort | Used sorting key from sortable. |
Um einen Eintrag für die Qualitätsprüfung zu erstellen, müssen Sie einen POST-Aufruf an die folgende URL senden:
https://mvsep.com/api/quality_checker/add
| Feld | Typ | Beschreibung |
|---|---|---|
| api_token | String | (erforderlich) Ihr API-Schlüssel |
| zipfile | Binär | (erforderlich) Zu verarbeitende Zip-Datei |
| algo_name | String | (erforderlich) Name des Algorithmus |
| main_text | String | (erforderlich) Beschreibung des Algorithmus |
| dataset_type | String | Datensatztyp. Standardwert ist 0.
|
| password | String | (erforderlich) Passwort zum Löschen des Algorithmus |
| ensemble | Integer | 0 - Algorithmus ist nicht Ensemble. 1 - Algorithmus ist Ensemble
|
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"'
| Schlüssel | Wert |
|---|---|
| success |
|
| data | Enthält Informationen über den Eintrag |
| data -> id | ID des Eintrags |
| data -> link | Link zum Eintrag |
Die MVSEP-API verwendet die folgenden Fehlercodes:
| Fehlercode | Bedeutung |
|---|---|
| 400 | Formular ist ungültig |
| 401 |
Unbekannter oder ungültiger api_token. Dieser Fehler erscheint, wenn Sie einen unbekannten API-Schlüssel verwenden
|
Um Informationen über den Eintrag in der Qualitätsprüfungswarteschlange anhand der ID zu erhalten, müssen Sie einen GET-Aufruf an die folgende URL durchführen:
https://mvsep.com/api/quality_checker/entry
| Feld | Typ | Beschreibung |
|---|---|---|
| id | Integer | (erforderlich) ID des Eintrags |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
Um einen Eintrag in der Qualitätsprüfungswarteschlange anhand von ID und Passwort zu löschen, müssen Sie einen GET-Aufruf an die folgende URL senden:
https://mvsep.com/api/quality_checker/delete
| Feld | Typ | Beschreibung |
|---|---|---|
| id | Integer | (erforderlich) ID des Eintrags |
| password | String | (erforderlich) Passwort für den Eintrag verwendet |
curl --location 'https://mvsep.com/api/quality_checker/delete' --form 'id="7720"' --form 'password="test"'
| Schlüssel | Wert |
|---|---|
| success |
|
| data->message | Zeigt an, ob der Eintrag gelöscht wurde. |
turbo@mvsep.com