UNLOCK API

API per risolvere Audio

Invia un task Audio all'API e ricevi la risposta che il tuo codice invia alla pagina. L'audio in base64 (MP3), fino a 500 KB, e la sua lingua. Ricevi: Le parole della registrazione.

In breve

Prezzo ogni 1,000
$0.25 ($0.00025 per task)
Tipo createTask
AudioTask
Metodo in.php
audio
Invii
L'audio in base64 (MP3), fino a 500 KB, e la sua lingua
Ricevi
Le parole della registrazione

Dove trovare i valori

Invia il file audio in base64 e imposta lang, ad esempio en.

createTask e getTaskResult

Crea il task, attendi circa 5 secondi, poi controlla il risultato ogni 5 secondi finché lo stato è ready. Se il task fallisce, l'API restituisce un errore e l'importo torna sul saldo.

import time, requests

API = "https://unlock-api.com"
KEY = "YOUR_API_KEY"

task = requests.post(f"{API}/createTask", json={
    "clientKey": KEY,
    "task": {
      "type": "AudioTask",
      "body": "SUQzBAAAAAAAI1RTU0U...",
      "lang": "en"
    }
}).json()
if task["errorId"]:
    raise SystemExit(task["errorCode"])

for _ in range(60):   # 60 x 5 s = the 5 minute task limit
    time.sleep(5)
    r = requests.post(f"{API}/getTaskResult", json={"clientKey": KEY, "taskId": task["taskId"]}).json()
    if r["errorId"]:
        raise SystemExit(f"{r['errorCode']}: {r.get('errorDescription', '')}")   # failed tasks are refunded
    if r["status"] == "ready":
        print(r["solution"]["text"])
        break
else:
    raise SystemExit("timed out")

in.php e res.php

Lo stesso task con la classica API a form. Aggiungi json=1 per ricevere risposte JSON; senza, le risposte sono in testo semplice, ad esempio OK|1001.

curl -s "https://unlock-api.com/in.php" -d "key=YOUR_API_KEY&method=audio&lang=en&body=BASE64_AUDIO&json=1"
# {"status":1,"request":"1001"}

curl -s "https://unlock-api.com/res.php?key=YOUR_API_KEY&action=get&id=1001&json=1"
# {"status":0,"request":"CAPCHA_NOT_READY"}  then  {"status":1,"request":"ANSWER"}

Riferimento API completo: tutti i parametri e l'oggetto solution