API 快速開始

TelkNet 暴露的是 Web 應用、GPU bridge 和 SDK 產生共同使用的 REST API。瀏覽器工作階段透過 telknet_session Cookie 認證。目前產品不提供使用者自主管理的個人 API Key。

讀取工具目錄

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。

上傳輸入檔案

先為選定工具建立預簽名上傳 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 提交給任務介面。

提交任務

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 下載結果。