API bắt đầu nhanh

TelkNet hiển thị cùng một API REST được ứng dụng web, cầu nối GPU và SDK sử dụng thế hệ. Phiên trình duyệt xác thực bằng cookie telknet_session. Khóa API cá nhân do người dùng quản lý không phải là một phần của sản phẩm hiện tại.

Đọc danh mục công cụ

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

Các tool IDs hiện tại gồm công cụ nhạc và âm thanh 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 và midi-lyrics, cùng các công cụ hình ảnh chordedit, ideogram-v4 và krea-2.

Các công cụ SOTA chạy trên GPU được liệt kê trong danh mục dưới 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 và audio-dnr-separation.

midi-converter chỉ xuất hiện trong danh mục dành cho ứng dụng Web: việc chuyển đổi chạy cục bộ trong trình duyệt và không hỗ trợ API tải lên hoặc gửi tác vụ.

midi-lyrics cũng chạy hoàn toàn trong trình duyệt: công cụ ghép tệp MIDI có sẵn với lời LRC có mốc thời gian và không tải tệp nào lên máy chủ.

Tải lên đầu vào

Tạo URL tải lên được chỉ định cho công cụ đã chọn:

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

Sử dụng URL được trả về để tải tệp lên, sau đó gửi file_key được trả về.

Gửi nhiệm vụ

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

Phản hồi trả về một id nhiệm vụ. Thăm dò GET /api/v1/tasks/:taskId cho đến khi hoàn thành nhiệm vụ kết thúc thì sử dụng GET /api/v1/tasks/:taskId/download hoặc GET /api/v1/tasks/:taskId/files/:fileId để biết kết quả.