APIクイックスタート

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-vocal-split、music-four-stem、music-six-stem, music-drum-split, music-mega-53-stem, music-eight-stem、 music-yourmt3、music-miros、music-piano-transkun、music-piano-transkun-v2-aug、music-piano-aria、 music-piano-bytedance-pedal、ai-rvc、zonos2-tts、midi-converter、 画像ツール chordedit、ideogram-v4、krea-2 が含まれます。

midi-converter は Web アプリ用としてのみカタログに掲載されています。変換はブラウザ内でローカルに実行され、アップロード API とタスク送信 API はサポートされません。

入力をアップロードする

選択したツール用に署名付きアップロード 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 で結果をダウンロードします。