API avvio rapido
Aggiornato 2026-06-30
Avvio rapido dell'API
TelkNet espone la stessa API REST utilizzata dall'app Web, dal bridge GPU e dall'SDK
generazione. Le sessioni del browser si autenticano con il cookie telknet_session.
Le chiavi API personali gestite dall'utente non fanno parte del prodotto corrente.
Leggi il catalogo degli strumenti
curl http://127.0.0.1:13000/api/v1/tools
Gli attuali tool IDs includono strumenti musica e audio 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 e midi-converter,
più gli strumenti immagine chordedit, ideogram-v4 e krea-2.
Carica input
Crea un URL di caricamento predefinito per uno strumento selezionato:
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}'
Utilizza l'URL restituito per caricare il file, quindi invia il codice file_key restituito.
Invia un'attività
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":{}}'
La risposta restituisce un ID attività. Interroga GET /api/v1/tasks/:taskId fino all'attività
finiture, quindi utilizzare GET /api/v1/tasks/:taskId/download o
GET /api/v1/tasks/:taskId/files/:fileId per i risultati.