turbo@mvsep.com
MVSEP API는 분리를 생성하고, 결과를 반환하고, 사이트 정보를 얻고, 사용자 기능을 제어할 수 있는 프로그래밍 방식의 액세스를 제공합니다.
이 API를 사용하려면 API 키가 필요합니다. 로그인하지 않았습니다. 로그인하여 API 토큰을 받아보세요.
Python 예제: https://github.com/ZFTurbo/MVSep-API-Examples
Mac용 비공식 애플리케이션 MacVSep: https://github.com/septcoco/macvsep
Webhook은 여기에서 설정할 수 있습니다: Webhook 페이지
OpenAPI 사양: mvsep-openapi-spec.json
프리미엄 사용자는 무제한 동시 작업을 요청할 수 있지만, 비프리미엄 사용자는 동시 작업 1개만 요청할 수 있습니다.
분리를 생성하기 위해서는 다음의 URL로 POST 호출을 해야 합니다.
https://mvsep.com/api/separation/create
| 필드 | 타입 | 설명 |
|---|---|---|
| api_token | 문자열 | 당신의 API 키 |
| audiofile | 바이너리 | 처리할 오디오 파일입니다. url 매개변수가 설정되어 있거나 모델이 파일 입력을 사용하지 않는 경우에는 필요하지 않습니다. 매처링 모델의 경우 입력에 audiofile 대신 target_audiofile 및 reference_audiofile을 사용하세요. |
| url | 문자열 | 오디오 파일 링크입니다. audiofile 매개변수가 설정된 경우에는 필요하지 않습니다. |
| remote_type | 문자열 | (선택 사항) 오디오 파일의 원격 유형입니다. 기본값은 direct입니다. audiofile 매개변수가 설정된 경우에는 필요하지 않습니다. 지원되는 유형은 direct(직접 다운로드), mega(MEGA), drive(Google Drive), dropbox(Dropbox)입니다. |
| sep_type | 정수 | (선택 과목) 분리 유형, 기본값은 11입니다 (Demucs3 모델 B (보컬, 드럼, 베이스, 기타)) |
| add_opt1 | 문자열 | (선택 과목) 분리 유형 첫 번째 추가 필드 |
| add_opt2 | 문자열 | (선택 과목) 분리 유형 두 번째 추가 필드 |
| add_opt3 | 문자열 | (선택 사항) 분리 유형 세 번째 추가 필드 |
| output_format | 정수 | (선택 과목) 출력 형식, 기본값은 0입니다 (mp3 (320kbps)) |
| is_demo | 불리언 | (선택 과목) 분리 결과를 데모 페이지에 게시할 것인가, 기본값은 false입니다. |
| 이름 | 값 | 추가 필드 |
|---|---|---|
| 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 옵션들:
|
| BS PolarFormer (vocals, instrumental) | 123 | 키: add_opt1 이름: Overlap 옵션들:
|
| MelBand Roformer (vocals, instrumental) | 48 | 키: add_opt1 이름: Vocal model type 옵션들:
|
| 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 옵션들:
|
| 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 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 (braam , other) | 117 | |
| MVSep FX (fx, other) | 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 옵션들:
|
| 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 | |
| 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 | 생성된 작업의 "GET RESULT" URL에 대한 링크 표시(success가 true인 경우에만 표시됨) |
| data -> hash | 생성된 작업 해시를 표시합니다(success가 true인 경우에만 표시됨). |
| data -> message | 오류에 대한 설명을 표시합니다(success가 false인 경우에만 표시됨). |
MVSEP API는 다음 오류 코드를 사용합니다:
| 오류 코드 | 의미 |
|---|---|
| 400 | 일부 매개변수가 누락되었거나 유효하지 않습니다. 필수 매개변수를 모두 전달하지 않거나 잘못된 매개변수를 전달할 때 이 오류가 발생합니다. |
| 401 |
알 수 없거나 유효하지 않은 api_token. 알려지지 않은 API 키를 사용할 경우 이 오류가 나타납니다.
|
분리 결과를 얻으려면 다음 URL로 GET 요청을 해야 합니다:
https://mvsep.com/api/separation/get
| 필드 | 타입 | 설명 |
|---|---|---|
| hash | 문자열 | 분리 해시 |
| mirror | 정수 | (선택 사항) 1로 설정된 경우 다른 미러를 사용하고 기본값은 0입니다. 1로 설정된 경우 api_token와 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인 경우에만 표시됨). |
원격 작업의 결과를 가져오려면 다음 URL로 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 | 생성된 작업의 "GET RESULT" URL 링크를 표시합니다(status가 done일 때만 표시). |
| data -> hash | 분리 해시를 표시합니다(status가 done일 때만 표시). |
분리를 취소하고 사용한 크레딧을 환불받으려면(분리가 아직 처리 중이 아닌 경우) 다음 URL로 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 |
|
분리 유형에 대한 자세한 데이터를 얻으려면 다음 URL로 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에 대한 최신 뉴스를 확인하려면 다음 URL로 GET 호출을 해야 합니다:
https://mvsep.com/api/app/news
| 필드 | 타입 | 설명 |
|---|---|---|
| lang | 문자열 | (선택 사항) 2글자 언어 코드(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 | 뉴스 날짜 |
사이트 대기열 정보를 가져오려면 다음 URL로 GET 호출을 해야 합니다:
https://mvsep.com/api/app/queue
| 필드 | 타입 | 설명 |
|---|---|---|
| api_token | 문자열 | (선택 사항) 사용자의 API 키 |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| 키 | 값 |
|---|---|
| queue |
다양한 요금제의 현재 대기열 배열을 포함합니다:
|
| plan |
현재 요금제의 현재 대기열을 포함합니다(등록/프리미엄 요금제로 요청하려면 api_token을 추가):
|
데모 분리에 대한 정보를 얻으려면 다음 URL에 대한 GET 호출을 수행해야 합니다.
https://mvsep.com/api/app/demo
| 필드 | 타입 | 설명 |
|---|---|---|
| start | 정수 | (선택 사항) 시작점 오프셋, 기본값은 0(즉, 최신부터 시작)입니다. |
| limit | 정수 | (선택 사항) 반환되는 최대 결과 수, 기본값은 10개, 최대값은 20개입니다. |
| algorithm_id | 정수 | 선택 사항인 분리 유형 ID입니다. 특정 알고리즘으로 생성된 데모 분리만 반환하려면 사용하세요. 값은 GET SEPARATION TYPES 엔드포인트의 render_id와 일치합니다. |
| options[FIELD] | 문자열 / 정수 | 알고리즘 옵션 값에 대한 선택적 필터입니다. FIELD를 GET SEPARATION TYPES 응답의 algorithm_fields -> name에 있는 추가 필드 키로 바꾼 다음, 해당 필드의 options 키 중 하나를 값으로 전달하세요. 예: options[vocals]=1. |
| additional_options | 문자열 | 저장된 작업 옵션 데이터에 대한 선택적 원시 포함 필터입니다. 새 통합에서는 명시적이고 조합하기 쉬운 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 목록을 확인하세요. options[FIELD] 안에는 필드 name을 사용하고, JSON 옵션 키 중 하나를 값으로 사용하세요.
데이터를 어레이로 반환합니다:
| 키 | 값 |
|---|---|
| hash | 분리 해시 |
| date | 분리 날짜 |
| input_audio | 오디오 URL 입력 |
| size | 입력 오디오 크기 |
| algorithm | 사용된 분리 유형에 대한 기본 정보를 포함합니다(반환된 매개변수에 대한 정보는 GET SEPARATION TYPES 탭 참조). |
사용자를 인증하고 사용자의 API 키를 받으려면 다음 URL로 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 API는 다음 오류 코드를 사용합니다:
| 오류 코드 | 의미 |
|---|---|
| 400 | 잘못된 자격 증명이 지정됨 |
MVSEP 사이트에 사용자를 등록하려면 다음 URL로 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 API는 다음 오류 코드를 사용합니다:
| 오류 코드 | 의미 |
|---|---|
| 400 | 양식이 잘못되었습니다 |
사용자 정보를 가져오려면 다음 URL로 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 API는 다음 오류 코드를 사용합니다:
| 오류 코드 | 의미 |
|---|---|
| 400 | 잘못된 API 키 |
사용자의 기본 정보 분리 기록을 가져오려면 다음 URL로 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 API는 다음 오류 코드를 사용합니다:
| 오류 코드 | 의미 |
|---|---|
| 400 | 잘못된 API 키 |
사용자의 프리미엄 사용을 활성화하려면 다음 URL로 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 API는 다음 오류 코드를 사용합니다:
| 오류 코드 | 의미 |
|---|---|
| 400 | 잘못된 API 키 |
사용자의 프리미엄 사용을 비활성화하려면 다음 URL로 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 API는 다음 오류 코드를 사용합니다:
| 오류 코드 | 의미 |
|---|---|
| 400 | 잘못된 API 키 |
사용자에게 긴 파일 이름을 사용하도록 설정하려면 다음 URL로 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 API는 다음 오류 코드를 사용합니다:
| 오류 코드 | 의미 |
|---|---|
| 400 | 잘못된 API 키 |
사용자의 긴 파일명을 사용하지 않으려면 다음 URL로 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 API는 다음 오류 코드를 사용합니다:
| 오류 코드 | 의미 |
|---|---|
| 400 | 잘못된 API 키 |
품질 검사기 대기열 항목 정보를 가져오려면 다음 URL로 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) | 해당 스템의 SDR |
| dataset_name | 데이터셋 이름 |
품질 검사기 리더보드 정보를 가져오려면 다음 URL로 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에서 사용된 정렬 키입니다. |
품질 검사기 항목을 생성하려면 다음 URL로 POST 호출을 해야 합니다:
https://mvsep.com/api/quality_checker/add
| 필드 | 타입 | 설명 |
|---|---|---|
| api_token | 문자열 | (필수) 당신의 API 키 |
| zipfile | 바이너리 | (필수) 처리할 ZIP 파일 |
| 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 | 항목 ID |
| data -> link | 항목 링크 |
MVSEP API는 다음 오류 코드를 사용합니다:
| 오류 코드 | 의미 |
|---|---|
| 400 | 양식이 잘못되었습니다 |
| 401 |
알 수 없거나 유효하지 않은 api_token. 알려지지 않은 API 키를 사용할 경우 이 오류가 나타납니다.
|
ID로 품질 검사기 대기열 항목 정보를 가져오려면 다음 URL로 GET 호출을 해야 합니다:
https://mvsep.com/api/quality_checker/entry
| 필드 | 타입 | 설명 |
|---|---|---|
| id | 정수 | (필수) 항목 ID |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
ID와 비밀번호로 품질 검사기 대기열 항목을 삭제하려면 다음 URL로 GET 호출을 해야 합니다:
https://mvsep.com/api/quality_checker/delete
| 필드 | 타입 | 설명 |
|---|---|---|
| id | 정수 | (필수) 항목 ID |
| password | 문자열 | (필수) 항목에 사용된 비밀번호 |
curl --location 'https://mvsep.com/api/quality_checker/delete' --form 'id="7720"' --form 'password="test"'
| 키 | 값 |
|---|---|
| success |
|
| data->message | 항목이 삭제되었는지 여부를 표시합니다 |
turbo@mvsep.com