Vodič za integraciju · API

Ažurirano 2026-10-22

Pozivajte alate putem HTTPS-a ličnim API ključem. Izvršite primjere redom za odvajanje vokala iz MP3. Prije promjene alata provjerite parametre i ograničenja.

Potrebni su Bash, curl 7.76+ i jq. Izvršavajte u istom terminalu.

Bash / curl ↓PowerShell 7 ↓Python 3 ↓

01Priprema i autentifikacija

Napravite ključ Čitanje i izvršavanje i pošaljite Authorization: Bearer. Cookie prijave, CSRF i obnavljanje sesije nisu potrebni.

Prazne liste dozvoljavaju sve alate i IP adrese; pravila računa i dalje važe. Budžeti koriste UTC. Prekinuti prenosi zadržavaju dodijeljeni obim. Novi ključ zadržava dozvole i datum isteka. Ažurirajte skripte u prijelaznom roku do pet minuta.

Napravi ključ →

Bash / curl

jq() { command jq "$@" | tr -d '\r'; }
read -rsp 'TELKNET_API_KEY: ' TELKNET_API_KEY; printf '\n'
export TELKNET_API_KEY
BASE="${TELKNET_BASE_URL:-https://telknet.cc}"
TOOL="${TELKNET_TOOL:-music-vocal-split}"
FILE="${TELKNET_FILE:-sample.mp3}"
curl --connect-timeout 10 --max-time 60 --fail-with-body "$BASE/api/v1/credits/balance" \
  -H "Authorization: Bearer $TELKNET_API_KEY"

02Pošalji datoteku

Zatražite potpisani URL i pošaljite original kroz PUT. Koristite stvaran broj bajtova i isti Content-Type.

Bash / curl

curl --connect-timeout 10 --max-time 60 --fail-with-body "$BASE/api/v1/tools/$TOOL/upload" \
  -H "Authorization: Bearer $TELKNET_API_KEY" \
  -H 'Content-Type: application/json' \
  -d "$(jq -n --arg filename "$(basename "$FILE")" \
    --argjson size "$(wc -c < "$FILE")" \
    '{filename:$filename,content_type:"audio/mpeg",file_size:$size}')" \
  -o upload.json || { cat upload.json >&2; exit 1; }
curl --connect-timeout 10 --max-time 1800 --fail-with-body --request PUT \
  -H 'Content-Type: audio/mpeg' --upload-file "$FILE" \
  "$(jq -r '.data.upload_url' upload.json)"

URL obično važi 15 minuta. Ne šaljite ključ za PUT. Primjer koristi jedan PUT; uz multipart_supported=true pošaljite parts pa upload/multipart/complete, ili abort pri grešci.

03Potvrdi cijenu i predaj

Preuzmite osnovnu cijenu alata/modela, pošaljite neizmijenjeno kao pricing i sačuvajte task_id. Količina i predobrada prate cijene alata; RVC obuka prvo traži analizu i ponudu obuke.

Bash / curl

printf '{}' > params.json
curl --connect-timeout 10 --max-time 60 --fail-with-body "$BASE/api/v1/tools/$TOOL/quote" \
  -H "Authorization: Bearer $TELKNET_API_KEY" \
  -H 'Content-Type: application/json' \
  -d "$(jq -n --slurpfile params params.json '{params:$params[0]}')" \
  -o quote.json || { cat quote.json >&2; exit 1; }
jq -n --arg tool "$TOOL" --arg key "$(jq -r '.data.s3_key' upload.json)" \
  --slurpfile params params.json --slurpfile quote quote.json \
  '{tool_id:$tool,file_key:$key,params:$params[0],pricing:$quote[0].data}' > request.json
REQUEST_KEY="$(date +%s)-$(od -An -N16 -tx1 /dev/urandom | tr -d ' \n')"
printf '%s' "$REQUEST_KEY" > request-key.txt
curl --connect-timeout 10 --max-time 60 --fail-with-body "$BASE/api/v1/tools/$TOOL/tasks" \
  -H "Authorization: Bearer $TELKNET_API_KEY" \
  -H "Idempotency-Key: $REQUEST_KEY" \
  -H 'Content-Type: application/json' --data-binary @request.json -o task.json || { cat task.json >&2; exit 1; }
TASK=$(jq -r '.data.task_id' task.json)

Ponuda ne rezerviše kredite. Kod 409 PRICE_CHANGED preuzmite i potvrdite novu cijenu. Generisanje muzike i referentni cover traže parametre odabranih modela.

Sačuvajte request-key.txt i request.json. Isti račun, Idempotency-Key i identičan sadržaj vraćaju izvorni zadatak. Za novi zadatak koristite novi ključ; prvo provjerite slanje nepoznatog ishoda.

04Provjeri napredak

Provjeravajte svake 3 sekunde. Preuzmite nakon completed; failed, timeout i cancelled su konačna stanja. Nakon dva sata završava čekanje, ne zadatak.

Bash / curl

deadline=$((SECONDS + 7200))
while (( SECONDS < deadline )); do
  curl --connect-timeout 10 --max-time 60 --fail-with-body "$BASE/api/v1/tasks/$TASK" \
    -H "Authorization: Bearer $TELKNET_API_KEY" -o status.json || { cat status.json >&2; exit 1; }
  status=$(jq -r '.data.status' status.json)
  case "$status" in
    completed) break ;;
    failed|timeout|cancelled) cat status.json >&2; exit 1 ;;
    pending|processing) sleep 3 ;;
    *) cat status.json >&2; exit 1 ;;
  esac
done
test "$(jq -r '.data.status' status.json)" = completed

05Preuzmi rezultate

URL-kodirajte s3_key iz output_files i koristite kao fileId. proxy=true prenosi original s istog izvora uz provjeru vlasništva.

Bash / curl

mkdir -p results
jq -r '.data.output_files | to_entries[] | .key' status.json | while read -r INDEX; do
  FILE_ID=$(jq -r --argjson i "$INDEX" '.data.output_files[$i].s3_key | @uri' status.json)
  NAME=$(basename "$(jq -r --argjson i "$INDEX" '.data.output_files[$i].name' status.json)")
  curl --connect-timeout 10 --max-time 7200 --fail-with-body "$BASE/api/v1/tasks/$TASK/files/$FILE_ID?proxy=true" \
    -H "Authorization: Bearer $TELKNET_API_KEY" \
    --output "results/$INDEX-$NAME.part" || exit 1
  EXPECTED=$(jq -r --argjson i "$INDEX" '.data.output_files[$i].size_bytes' status.json)
  test "$(wc -c < "results/$INDEX-$NAME.part")" -eq "$EXPECTED" || exit 1
  mv "results/$INDEX-$NAME.part" "results/$INDEX-$NAME"
done

Bearer zahtjevi na /api/v1/tasks/{taskId}/download izravno vraćaju izvornu datoteku ili ZIP. Važi rok čuvanja; API ključ se ne prosljeđuje pohrani objekata.

Greške i oporavak

Pročitajte HTTP status i izvorne error.code, message, details. Ne oslanjajte se samo na tekst i ne spremajte grešku kao rezultat.

400	Provjerite datoteku, parametre i JSON.
401	Ključ nedostaje, nije važeći, istekao je ili opozvan.
402	Nema dovoljno kredita; provjerite stanje.
403	Samo čitanje ili bez pristupa.
404	Resurs nedostaje ili pripada drugom računu.
409	Cijena ili stanje su promijenjeni; pročitajte kod.
413	Datoteka prelazi ograničenje alata.
429	Previše zahtjeva; čekajte Retry-After.
503	Održavanje ili privremeni kvar; sačuvajte grešku i provjerite kasnije.

Za 429 čekajte Retry-After ili ograničeno povećavajte čekanje. Ponavljajte samo sigurna čitanja. Nakon isteka POST zahtjeva prvo provjerite originalni rezultat, bez ponovnog stvaranja zadatka.

JSON

{
  "ok": false,
  "error": {
    "code": "API_KEY_SCOPE",
    "message": "Ovaj API ključ ne dozvoljava radnju.",
    "details": []
  }
}

Bash / curl

HTTP_CODE=$(curl --connect-timeout 10 --max-time 60 --silent --show-error \
  -H "Authorization: Bearer $TELKNET_API_KEY" \
  --output response.json --dump-header response.headers --write-out '%{http_code}' \
  "$BASE/api/v1/tasks/$TASK")
if [[ "$HTTP_CODE" != 2* ]]; then
  cat response.json >&2
  if [[ "$HTTP_CODE" == 429 ]]; then
    awk 'tolower($1)=="retry-after:" {print $2}' response.headers
  fi
  exit 1
fi

Sačuvajte task_id u task.json i nastavite provjeru. Nedavne predaje provjerite na listi; cancel koristite samo za zaustavljanje zadatka.

API pregled

Putanje koriste /api/v1 iste stranice. Ključevi pristupaju vlastitim resursima, ne upravljanju računom, stvaranju ključeva, administraciji ili internim callbackovima.

GET	`/api/v1/tools`	Katalog alata
GET	`/api/v1/tools/{toolId}`	Parametri i ograničenja
GET	`/api/v1/credits/balance`	Stanje kredita
POST	`/api/v1/tools/{toolId}/quote`	Trenutna cijena
POST	`/api/v1/tools/{toolId}/upload`	Pošalji datoteku
POST	`/api/v1/tools/{toolId}/tasks`	Potvrdi cijenu i predaj
GET	`/api/v1/tasks/{taskId}`	Provjeri napredak
GET	`/api/v1/tasks`	Vaši zadaci
GET	`/api/v1/tasks/{taskId}/files/{fileId}?proxy=true`	Preuzmi rezultate
POST	`/api/v1/tasks/{taskId}/cancel`	Otkaži vlastiti zadatak

midi-converter i midi-lyrics rade u pregledniku bez serverskog API-ja za slanje ili izvršavanje. Detalji drugih alata određuju stanje, formate, veličinu i parametre.

Katalog alata

<- Dokumentacija

Vodič za integraciju · API

Ažurirano 2026-10-22

Pozivajte alate putem HTTPS-a ličnim API ključem. Izvršite primjere redom za odvajanje vokala iz MP3. Prije promjene alata provjerite parametre i ograničenja.

Potrebni su Bash, curl 7.76+ i jq. Izvršavajte u istom terminalu.

Bash / curl ↓PowerShell 7 ↓Python 3 ↓

01Priprema i autentifikacija

Napravite ključ Čitanje i izvršavanje i pošaljite Authorization: Bearer. Cookie prijave, CSRF i obnavljanje sesije nisu potrebni.

Napravi ključ →

Bash / curl

jq() { command jq "$@" | tr -d '\r'; }
read -rsp 'TELKNET_API_KEY: ' TELKNET_API_KEY; printf '\n'
export TELKNET_API_KEY
BASE="${TELKNET_BASE_URL:-https://telknet.cc}"
TOOL="${TELKNET_TOOL:-music-vocal-split}"
FILE="${TELKNET_FILE:-sample.mp3}"
curl --connect-timeout 10 --max-time 60 --fail-with-body "$BASE/api/v1/credits/balance" \
  -H "Authorization: Bearer $TELKNET_API_KEY"

02Pošalji datoteku

Zatražite potpisani URL i pošaljite original kroz PUT. Koristite stvaran broj bajtova i isti Content-Type.

Bash / curl

curl --connect-timeout 10 --max-time 60 --fail-with-body "$BASE/api/v1/tools/$TOOL/upload" \
  -H "Authorization: Bearer $TELKNET_API_KEY" \
  -H 'Content-Type: application/json' \
  -d "$(jq -n --arg filename "$(basename "$FILE")" \
    --argjson size "$(wc -c < "$FILE")" \
    '{filename:$filename,content_type:"audio/mpeg",file_size:$size}')" \
  -o upload.json || { cat upload.json >&2; exit 1; }
curl --connect-timeout 10 --max-time 1800 --fail-with-body --request PUT \
  -H 'Content-Type: audio/mpeg' --upload-file "$FILE" \
  "$(jq -r '.data.upload_url' upload.json)"

URL obično važi 15 minuta. Ne šaljite ključ za PUT. Primjer koristi jedan PUT; uz multipart_supported=true pošaljite parts pa upload/multipart/complete, ili abort pri grešci.

03Potvrdi cijenu i predaj

Preuzmite osnovnu cijenu alata/modela, pošaljite neizmijenjeno kao pricing i sačuvajte task_id. Količina i predobrada prate cijene alata; RVC obuka prvo traži analizu i ponudu obuke.

Bash / curl

printf '{}' > params.json
curl --connect-timeout 10 --max-time 60 --fail-with-body "$BASE/api/v1/tools/$TOOL/quote" \
  -H "Authorization: Bearer $TELKNET_API_KEY" \
  -H 'Content-Type: application/json' \
  -d "$(jq -n --slurpfile params params.json '{params:$params[0]}')" \
  -o quote.json || { cat quote.json >&2; exit 1; }
jq -n --arg tool "$TOOL" --arg key "$(jq -r '.data.s3_key' upload.json)" \
  --slurpfile params params.json --slurpfile quote quote.json \
  '{tool_id:$tool,file_key:$key,params:$params[0],pricing:$quote[0].data}' > request.json
REQUEST_KEY="$(date +%s)-$(od -An -N16 -tx1 /dev/urandom | tr -d ' \n')"
printf '%s' "$REQUEST_KEY" > request-key.txt
curl --connect-timeout 10 --max-time 60 --fail-with-body "$BASE/api/v1/tools/$TOOL/tasks" \
  -H "Authorization: Bearer $TELKNET_API_KEY" \
  -H "Idempotency-Key: $REQUEST_KEY" \
  -H 'Content-Type: application/json' --data-binary @request.json -o task.json || { cat task.json >&2; exit 1; }
TASK=$(jq -r '.data.task_id' task.json)

Ponuda ne rezerviše kredite. Kod 409 PRICE_CHANGED preuzmite i potvrdite novu cijenu. Generisanje muzike i referentni cover traže parametre odabranih modela.

04Provjeri napredak

Provjeravajte svake 3 sekunde. Preuzmite nakon completed; failed, timeout i cancelled su konačna stanja. Nakon dva sata završava čekanje, ne zadatak.

Bash / curl

deadline=$((SECONDS + 7200))
while (( SECONDS < deadline )); do
  curl --connect-timeout 10 --max-time 60 --fail-with-body "$BASE/api/v1/tasks/$TASK" \
    -H "Authorization: Bearer $TELKNET_API_KEY" -o status.json || { cat status.json >&2; exit 1; }
  status=$(jq -r '.data.status' status.json)
  case "$status" in
    completed) break ;;
    failed|timeout|cancelled) cat status.json >&2; exit 1 ;;
    pending|processing) sleep 3 ;;
    *) cat status.json >&2; exit 1 ;;
  esac
done
test "$(jq -r '.data.status' status.json)" = completed

05Preuzmi rezultate

URL-kodirajte s3_key iz output_files i koristite kao fileId. proxy=true prenosi original s istog izvora uz provjeru vlasništva.

Bash / curl

mkdir -p results
jq -r '.data.output_files | to_entries[] | .key' status.json | while read -r INDEX; do
  FILE_ID=$(jq -r --argjson i "$INDEX" '.data.output_files[$i].s3_key | @uri' status.json)
  NAME=$(basename "$(jq -r --argjson i "$INDEX" '.data.output_files[$i].name' status.json)")
  curl --connect-timeout 10 --max-time 7200 --fail-with-body "$BASE/api/v1/tasks/$TASK/files/$FILE_ID?proxy=true" \
    -H "Authorization: Bearer $TELKNET_API_KEY" \
    --output "results/$INDEX-$NAME.part" || exit 1
  EXPECTED=$(jq -r --argjson i "$INDEX" '.data.output_files[$i].size_bytes' status.json)
  test "$(wc -c < "results/$INDEX-$NAME.part")" -eq "$EXPECTED" || exit 1
  mv "results/$INDEX-$NAME.part" "results/$INDEX-$NAME"
done

Bearer zahtjevi na /api/v1/tasks/{taskId}/download izravno vraćaju izvornu datoteku ili ZIP. Važi rok čuvanja; API ključ se ne prosljeđuje pohrani objekata.

Greške i oporavak

Pročitajte HTTP status i izvorne error.code, message, details. Ne oslanjajte se samo na tekst i ne spremajte grešku kao rezultat.

400	Provjerite datoteku, parametre i JSON.
401	Ključ nedostaje, nije važeći, istekao je ili opozvan.
402	Nema dovoljno kredita; provjerite stanje.
403	Samo čitanje ili bez pristupa.
404	Resurs nedostaje ili pripada drugom računu.
409	Cijena ili stanje su promijenjeni; pročitajte kod.
413	Datoteka prelazi ograničenje alata.
429	Previše zahtjeva; čekajte Retry-After.
503	Održavanje ili privremeni kvar; sačuvajte grešku i provjerite kasnije.

Za 429 čekajte Retry-After ili ograničeno povećavajte čekanje. Ponavljajte samo sigurna čitanja. Nakon isteka POST zahtjeva prvo provjerite originalni rezultat, bez ponovnog stvaranja zadatka.

JSON

{
  "ok": false,
  "error": {
    "code": "API_KEY_SCOPE",
    "message": "Ovaj API ključ ne dozvoljava radnju.",
    "details": []
  }
}

Bash / curl

HTTP_CODE=$(curl --connect-timeout 10 --max-time 60 --silent --show-error \
  -H "Authorization: Bearer $TELKNET_API_KEY" \
  --output response.json --dump-header response.headers --write-out '%{http_code}' \
  "$BASE/api/v1/tasks/$TASK")
if [[ "$HTTP_CODE" != 2* ]]; then
  cat response.json >&2
  if [[ "$HTTP_CODE" == 429 ]]; then
    awk 'tolower($1)=="retry-after:" {print $2}' response.headers
  fi
  exit 1
fi

Sačuvajte task_id u task.json i nastavite provjeru. Nedavne predaje provjerite na listi; cancel koristite samo za zaustavljanje zadatka.

API pregled

Putanje koriste /api/v1 iste stranice. Ključevi pristupaju vlastitim resursima, ne upravljanju računom, stvaranju ključeva, administraciji ili internim callbackovima.

GET	`/api/v1/tools`	Katalog alata
GET	`/api/v1/tools/{toolId}`	Parametri i ograničenja
GET	`/api/v1/credits/balance`	Stanje kredita
POST	`/api/v1/tools/{toolId}/quote`	Trenutna cijena
POST	`/api/v1/tools/{toolId}/upload`	Pošalji datoteku
POST	`/api/v1/tools/{toolId}/tasks`	Potvrdi cijenu i predaj
GET	`/api/v1/tasks/{taskId}`	Provjeri napredak
GET	`/api/v1/tasks`	Vaši zadaci
GET	`/api/v1/tasks/{taskId}/files/{fileId}?proxy=true`	Preuzmi rezultate
POST	`/api/v1/tasks/{taskId}/cancel`	Otkaži vlastiti zadatak

midi-converter i midi-lyrics rade u pregledniku bez serverskog API-ja za slanje ili izvršavanje. Detalji drugih alata određuju stanje, formate, veličinu i parametre.

Katalog alata