بداية سريعة API
تم التحديث 2026-06-30
واجهة برمجة التطبيقات السريعة
تعرض TelkNet نفس واجهة REST API التي يستخدمها تطبيق الويب وجسر GPU وSDK
جيل. تتم مصادقة جلسات المتصفح باستخدام ملف تعريف الارتباط telknet_session.
لا تعد مفاتيح واجهة برمجة التطبيقات الشخصية التي يديرها المستخدم جزءًا من المنتج الحالي.
اقرأ كتالوج الأداة
curl http://127.0.0.1:13000/api/v1/tools
تشمل tool IDs الحالية أدوات الموسيقى والصوت music-vocal-split، music-four-stem، music-six-stem،
music-yourmt3، music-miros، music-piano-transkun، music-piano-aria،
music-piano-bytedance-pedal، ai-rvc، zonos2-tts وmidi-converter،
بالإضافة إلى أدوات الصور chordedit، ideogram-v4 وkrea-2.
تحميل المدخلات
أنشئ عنوان 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 للنتائج.