APIクイックスタート
更新 2026-08-13
TelkNet は、Web アプリ、GPU bridge、生成された SDK が共通利用する REST API を公開しています。ブラウザーセッションは
telknet_session Cookie で認証します。ユーザー管理の個人 API キーは現在の製品には含まれていません。
ツールカタログを取得する
curl http://127.0.0.1:13000/api/v1/tools
現在の tool IDs には、音楽・音声ツール music-vocal-harmony-split, music-dry-vocal, music-vocal-split、music-four-stem、music-six-stem, music-drum-split, music-mega-53-stem, music-eight-stem、
music-yourmt3、music-miros、music-restoration、music-custom-stem、music-piano-transkun、music-piano-transkun-standard、music-piano-transkun-v2-aug、music-piano-aria、
music-piano-bytedance-pedal、ai-rvc、zonos2-tts、midi-converter、midi-lyrics、
画像ツール chordedit、ideogram-v4、krea-2 が含まれます。
GPU 対応の SOTA ツールは music-muscriptor、music-piano-d3rm、music-piano-video-midi、music-lyrics-guided-vocal-midi、music-audio-to-lead-sheet、midi-to-score、music-instrument-midi、music-vocal-midi、music-beat-tracking、music-general-midi、music-drum-midi、music-guitar-tab、music-chord-analysis、music-audio-alignment、audio-dnr-separation にカタログされています。
midi-converter は Web アプリ用としてのみカタログに掲載されています。変換はブラウザ内でローカルに実行され、アップロード API とタスク送信 API はサポートされません。
midi-lyrics もブラウザー内だけで動作し、既存の MIDI にタイムスタンプ付き LRC 歌詞を追加します。どちらのファイルもアップロードしません。
入力をアップロードする
選択したツール用に署名付きアップロード URL を作成します。
curl -X POST http://127.0.0.1:13000/api/v1/tools/music-vocal-split/upload \
-H "Cookie: telknet_session=YOUR_SESSION_COOKIE; telknet_csrf=YOUR_CSRF_TOKEN" \
-H "X-CSRF-Token: YOUR_CSRF_TOKEN" \
-H "X-Requested-With: XMLHttpRequest" \
-H "Origin: http://127.0.0.1:13001" \
-H "Content-Type: application/json" \
-d '{"filename":"sample.mp3","content_type":"audio/mpeg","file_size":1234567}'
返された URL にファイルをアップロードし、返された file_key をタスク API に送信します。
タスクを送信する
curl -X POST http://127.0.0.1:13000/api/v1/tools/music-vocal-split/tasks \
-H "Cookie: telknet_session=YOUR_SESSION_COOKIE; telknet_csrf=YOUR_CSRF_TOKEN" \
-H "X-CSRF-Token: YOUR_CSRF_TOKEN" \
-H "X-Requested-With: XMLHttpRequest" \
-H "Origin: http://127.0.0.1:13001" \
-H "Content-Type: application/json" \
-d '{"tool_id":"music-vocal-split","file_key":"uploads/example.mp3","params":{}}'
レスポンスにはタスク ID が返ります。以後 GET /api/v1/tasks/:taskId をポーリングし、完了後に
GET /api/v1/tasks/:taskId/download または
GET /api/v1/tasks/:taskId/files/:fileId で結果をダウンロードします。