API เริ่มต้นใช้งานด่วน

TelkNet เปิดเผย REST API เดียวกันกับที่ใช้โดยเว็บแอป, บริดจ์ GPU และ SDK รุ่น เซสชันเบราว์เซอร์ตรวจสอบสิทธิ์ด้วยคุกกี้ 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 เท่านั้น: การแปลงทำงานภายในเบราว์เซอร์โดยตรง และไม่รองรับ 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":{}}'

การตอบกลับส่งคืนรหัสงาน สำรวจ GET /api/v1/tasks/:taskId จนกระทั่งถึงงาน เสร็จสิ้นแล้วใช้ GET /api/v1/tasks/:taskId/download หรือ GET /api/v1/tasks/:taskId/files/:fileId สำหรับผลลัพธ์