Inicio rápido de API

TelkNet expone la misma API REST utilizada por la aplicación web, el puente GPU y el SDK generación. Las sesiones del navegador se autentican con la cookie telknet_session. Las claves API personales administradas por el usuario no forman parte del producto actual.

Leer el catálogo de herramientas

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

Los tool IDs actuales incluyen herramientas de música y 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 y midi-converter, además de las herramientas de imagen chordedit, ideogram-v4 y krea-2.

Cargar entrada

Cree una URL de carga prefirmada para una herramienta seleccionada:

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

Utilice la URL devuelta para cargar el archivo y luego envíe el file_key devuelto.

Enviar una tarea

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 respuesta devuelve una identificación de tarea. Encuesta GET /api/v1/tasks/:taskId hasta la tarea termina, luego use GET /api/v1/tasks/:taskId/download o GET /api/v1/tasks/:taskId/files/:fileId para obtener resultados.