API البدء السريع

تعرض TelkNet نفس واجهة REST API التي يستخدمها تطبيق الويب وجسر GPU وSDK جيل. تتم مصادقة جلسات المتصفح باستخدام ملف تعريف الارتباط telknet_session. لا تعد مفاتيح واجهة برمجة التطبيقات الشخصية التي يديرها المستخدم جزءًا من المنتج الحالي.

اقرأ كتالوج الأداة

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 في الدليل لتطبيق الويب فقط: تتم عملية التحويل محليًا في المتصفح، ولا يدعم واجهتي 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 للنتائج.