turbo@mvsep.com
MVSEP API は、分離の作成、結果の返還、サイト情報の取得、およびユーザー機能の制御を行うためのプログラムによるアクセスを提供します。
このAPIを使用するには、APIキーが必要です ログインしていない場合は、ログインしてAPIトークンを取得してください。
Python の例: https://github.com/ZFTurbo/MVSep-API-Examples
Mac OS 用非公式アプリケーション MacVSep: https://github.com/septcoco/macvsep
Webhookはここで設定できます: Webhooksページ
OpenAPI仕様: mvsep-openapi-spec.json
プレミアムユーザーは無制限の同時ジョブをリクエストできますが、非プレミアムユーザーは1つの同時ジョブしかリクエストできません。
MVSEP runs regional API endpoints. All regions share one account database, so the same account, API key and job hashes work everywhere:
https://de.mvsep.com/apihttps://hk.mvsep.com/apiRequests to https://mvsep.com/api are geo-steered to the region nearest to the caller. For API integrations we recommend calling a regional endpoint explicitly — it keeps the whole job lifecycle on one host regardless of where your requests originate from.
Every separation is processed and stored in the region where it was created, and the download URLs returned in responses always point to that region's host. For best performance, choose the endpoint closest to your servers and use the same host for the whole job lifecycle — create, status polling and file downloads.
You can query the status of any job from any region (the database is shared), but the output files themselves are always served by the region that owns the job.
分離を作成するには、以下の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 | 整数 | (オプション) Separation Type、デフォルトは11 (Demucs3 Model B (ボーカル、ドラム、ベース、その他)) |
| add_opt1 | 文字列 | (オプション) 分離タイプ 最初の追加フィールド |
| add_opt2 | 文字列 | (オプション) セパレーション・タイプ 2番目の追加フィールド |
| add_opt3 | 文字列 | (オプション) 分離タイプ 3 番目の追加フィールド |
| output_format | 整数 | (オプション) 出力フォーマット、デフォルトは 0 (mp3 (320kbps)) |
| is_demo | ブール演算 | (オプション) 分離をデモページに公開するかどうか。 |
| 名称 | 価値 | 追加フィールド |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | キー: add_opt1 名称: Output files オプション:
キー: add_opt2 名称: Model Type オプション:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | キー: add_opt1 名称: Output files オプション:
キー: add_opt2 名称: Model Type オプション:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | キー: add_opt1 名称: Output files オプション:
キー: add_opt2 名称: Model Type オプション:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| Demucs4 HT (vocals, drums, bass, other) | 20 | キー: add_opt1 名称: Model type オプション:
|
| BS Roformer (vocals, instrumental) | 40 | キー: add_opt1 名称: Vocal model type オプション:
キー: add_opt2 名称: Overlap オプション:
|
| BS PolarFormer (vocals, instrumental) | 123 | キー: add_opt1 名称: Model type オプション:
キー: add_opt2 名称: Overlap オプション:
|
| MelBand Roformer (vocals, instrumental) | 48 | キー: add_opt1 名称: Vocal model type オプション:
キー: add_opt2 名称: Overlap オプション:
|
| MDX23C (vocals, instrumental) | 25 | キー: add_opt1 名称: Vocal model type オプション:
|
| SCNet (vocals, instrumental) | 46 | キー: add_opt1 名称: Vocal model type オプション:
|
| MDX B (vocals, instrumental) | 23 | キー: add_opt1 名称: Vocal model type オプション:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | キー: add_opt1 名称: Model Type オプション:
キー: add_opt2 名称: Agressiveness オプション:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MVSep Karaoke (lead/back vocals) | 49 | キー: add_opt1 名称: Karaoke model type オプション:
キー: add_opt2 名称: Extraction type オプション:
|
| MDX-B Karaoke (lead/back vocals) | 12 | キー: add_opt1 名称: Karaoke model type オプション:
|
| MVSep Crowd removal (crowd, other) | 34 | キー: add_opt1 名称: Model type オプション:
|
| Medley Vox (Multi-singer separation) | 53 | キー: add_opt1 名称: Model type オプション:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | キー: add_opt1 名称: Model Type オプション:
キー: add_opt2 名称: Processing Mode オプション:
|
| MVSep Male/Female separation | 57 | キー: add_opt1 名称: Model type オプション:
キー: add_opt2 名称: How to extract オプション:
|
| MVSep Choir (choir, other) | 112 | キー: add_opt2 名称: How to extract オプション:
|
| MVSep SATB Choir (soprano, alto, tenor, bass) | 111 | キー: add_opt1 名称: Model type オプション:
キー: add_opt2 名称: How to extract オプション:
|
| MVSep Drums (drums, other) | 44 | キー: add_opt1 名称: Drums model type オプション:
キー: add_opt2 名称: How to extract オプション:
キー: add_opt3 名称: Output files オプション:
|
| MVSep Bass (bass, other) | 41 | キー: add_opt1 名称: Bass model type オプション:
キー: add_opt2 名称: How to extract オプション:
キー: add_opt3 名称: Output files オプション:
|
| MVSep Synth (synth, other) | 88 | キー: add_opt1 名称: How to extract オプション:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | キー: add_opt1 名称: Model Type オプション:
キー: add_opt2 名称: Preprocess オプション:
|
| MVSep Piano (piano, other) | 29 | キー: add_opt1 名称: Piano model type オプション:
|
| MVSep Digital Piano (digital-piano, other) | 79 | キー: add_opt2 名称: How to extract オプション:
|
| MVSep Keys (keys, other) | 106 | |
| MVSep Organ (organ, other) | 58 | キー: add_opt1 名称: Organ model type オプション:
|
| MVSep Harpsichord (harpsichord, other) | 91 | |
| MVSep Accordion (accordion, other) | 99 | |
| MVSep 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 | 作成したジョブの「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 | 作成されたジョブの「結果を取得」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>のキーの 1 つです> |
| 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。これを使用すると、1つのアルゴリズムのみで作成されたデモ分離が返されます。値は、GET SEPARATION TYPESエンドポイントのrender_idと一致します。 |
| options[FIELD] | 文字列／整数 | アルゴリズムオプション値のオプションフィルタ。GET SEPARATION TYPES レスポンスの algorithm_fields -> name から追加のフィールドキーを FIELD に置き換え、そのフィールドの 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 リストを調べます。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