UNLOCK API

Audio Lösungs-API

Senden Sie eine Audio-Aufgabe an die API und erhalten Sie die Antwort, die Ihr Code an die Seite übermittelt. Das Audio als base64 (MP3), bis 500 KB, und seine Sprache. Sie erhalten: Die Wörter in der Aufnahme.

Auf einen Blick

Preis pro 1.000
$0.25 ($0.00025 pro Aufgabe)
createTask-Typ
AudioTask
in.php-Methode
audio
Sie senden
Das Audio als base64 (MP3), bis 500 KB, und seine Sprache
Sie erhalten
Die Wörter in der Aufnahme

Wo Sie die Werte finden

Senden Sie die Audiodatei als base64 und setzen Sie lang, zum Beispiel en.

createTask und getTaskResult

Erstellen Sie die Aufgabe, warten Sie etwa 5 Sekunden und prüfen Sie dann alle 5 Sekunden das Ergebnis, bis der Status ready ist. Schlägt die Aufgabe fehl, liefert die API einen Fehler und der Betrag geht auf Ihr Guthaben zurück.

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 und res.php

Dieselbe Aufgabe mit der klassischen Formular-API. Mit json=1 erhalten Sie JSON-Antworten, ohne diesen Parameter Text wie 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"}

Vollständige API-Referenz: alle Parameter und das solution-Objekt