API γρήγορη εκκίνηση

Το TelkNet εκθέτει το ίδιο REST API που χρησιμοποιείται από την εφαρμογή ιστού, τη γέφυρα GPU και το SDK γενιά. Οι περίοδοι λειτουργίας προγράμματος περιήγησης ελέγχουν ταυτότητας με το cookie 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. Τα εργαλεία SOTA με υποστήριξη GPU καταχωρίζονται στα 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: η μετατροπή εκτελείται τοπικά στο πρόγραμμα περιήγησης και δεν υποστηρίζονται τα APIs μεταφόρτωσης ή υποβολής εργασιών.

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

Η απάντηση επιστρέφει ένα αναγνωριστικό εργασίας. Δημοσκόπηση GET /api/v1/tasks/:taskId μέχρι την εργασία τελειώνει και, στη συνέχεια, χρησιμοποιήστε το GET /api/v1/tasks/:taskId/download ή GET /api/v1/tasks/:taskId/files/:fileId για αποτελέσματα.