API краткое руководство
Обновлено 2026-06-30
Краткое руководство по API
TelkNet предоставляет тот же REST API, который используется веб-приложением, мостом графического процессора и SDK.
поколение. Сеансы браузера аутентифицируются с помощью файла cookie telknet_session.
Персональные ключи API, управляемые пользователем, не являются частью текущего продукта.
Прочтите каталог инструментов
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 для получения результатов.