API 퀵스타트

TelkNet은 웹 앱, GPU bridge, 생성된 SDK가 함께 사용하는 REST API를 제공합니다. 브라우저 세션은 telknet_session 쿠키로 인증합니다. 사용자가 직접 관리하는 개인 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로 결과를 다운로드합니다.