API Quickstart

TelkNet stellt dieselbe REST-API bereit, die von der Web-App, der GPU-Bridge und dem SDK verwendet wird Generation. Browsersitzungen werden mit dem Cookie telknet_session authentifiziert. Vom Benutzer verwaltete persönliche API-Schlüssel sind nicht Teil des aktuellen Produkts.

Lesen Sie den Werkzeugkatalog

curl http://127.0.0.1:13000/api/v1/tools

Aktuelle tool IDs umfassen die Musik- und Audio-Tools 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 und midi-lyrics, sowie die Bild-Tools chordedit, ideogram-v4 und krea-2.

Die GPU-gestützten SOTA-Tools sind unter 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 und audio-dnr-separation katalogisiert.

midi-converter ist nur für die Web-App im Katalog aufgeführt: Die Konvertierung erfolgt lokal im Browser; Upload- und Task-Einreichungs-APIs werden nicht unterstützt.

Auch midi-lyrics läuft vollständig im Browser: Das Werkzeug verbindet eine vorhandene MIDI-Datei mit zeitcodiertem LRC-Text, ohne eine der Dateien hochzuladen.

Eingabe hochladen

Erstellen Sie eine vorsignierte Upload-URL für ein ausgewähltes Tool:

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}'

Verwenden Sie die zurückgegebene URL, um die Datei hochzuladen, und senden Sie dann das zurückgegebene file_key.

Senden Sie eine Aufgabe

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":{}}'

Die Antwort gibt eine Aufgaben-ID zurück. Abfrage GET /api/v1/tasks/:taskId bis zur Aufgabe fertig ist, dann verwenden Sie GET /api/v1/tasks/:taskId/download oder GET /api/v1/tasks/:taskId/files/:fileId für Ergebnisse.