API 快速开始

TelkNet 的 REST API 同时供 Web 应用、GPU bridge 和 SDK 生成的客户端使用。浏览器会话通过 telknet_session Cookie 认证。当前产品不提供用户自主管理的个人 API Key。

读取工具目录

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。

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 提交给任务接口。

提交任务

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 下载结果。