Equalang

Was macht Equalang?

Zeigen Sie auf eine Datei und Equalang lädt sie hoch, wartet auf den Auftrag und schreibt die Ergebnisse neben die Quelle. Sie erhalten Pfade zurück, niemals den Inhalt der Datei – Layout, Tabellen, Bilder und Formeln bleiben erhalten, und nichts Großes gelangt in die Konversation.

Die Arbeit verbraucht das Guthaben des Benutzers. Sagen Sie, was es kosten wird, und holen Sie seine Zustimmung ein, bevor Sie translate oder transcribe ausführen. estimate liefert die Zahl für eine Datei kostenlos.

Einrichtung

Der Schlüssel ist eine Zeile, EQUALANG_API_KEY=el_..., in ~/.config/equalang/.env (unter $XDG_CONFIG_HOME, falls gesetzt): eine Datei pro Rechner, die mit dem Equalang MCP-Server geteilt wird und erhalten bleibt, wenn dieses Skill neu installiert oder aktualisiert wird. Der Benutzer erstellt den Schlüssel unter https://equalang.com/api-keys.

dir="${XDG_CONFIG_HOME:-$HOME/.config}/equalang"
mkdir -p "$dir" && (umask 077 && echo 'EQUALANG_API_KEY=el_...' > "$dir/.env")

EQUALANG_API_KEY in der Umgebung hat Vorrang vor der Datei. Ohne Schlüssel antwortet jeder Befehl mit einer Anleitung, wie man einen erhält und wohin er gehört. Erfinden Sie niemals einen Schlüssel – fragen Sie den Benutzer.

Befehle

Führen Sie sie aus dem Verzeichnis dieses Skills aus; python3 und sonst nichts wird benötigt. Jeder Befehl gibt ein JSON-Objekt aus; --help listet die Flags eines Befehls auf.

# Was würde es kosten? Lädt hoch, ohne etwas zu starten; kostenlos. `kept_until` gibt an, wie lange der Upload aufbewahrt wird.
python3 scripts/equalang.py estimate report.pdf
#   -> {"file_id": "...", "credits_to_translate": 12.34, "credits_to_transcribe": null, ...}

# Eine Datei übersetzen. Ein Pfad, eine öffentliche URL (Equalang ruft sie ab) oder --file-id von estimate.
python3 scripts/equalang.py translate report.pdf --to zh-CN
python3 scripts/equalang.py translate --file-id <file_id> --to zh-CN        # kein zweiter Upload
python3 scripts/equalang.py translate https://example.com/deck.pptx --to ja -o ./out

# Eine Aufnahme: übersetzte Untertitel oder was in der gesprochenen Sprache gesagt wurde.
python3 scripts/equalang.py translate talk.mp4 --to en --bilingual --format srt --format txt
python3 scripts/equalang.py transcribe interview.mp3 --format srt --format txt

# Zeichenketten in großen Mengen (jede einzeln übersetzt; höchstens 50 mit 5.000 Zeichen, 20.000 pro Aufruf).
python3 scripts/equalang.py text "Änderungen speichern" "Projekt löschen" --to de
# Ein langer Klartext – ein Artikel, Notizen, eine .md – bis zu 100.000 Zeichen. Equalang teilt ihn an Satzgrenzen: niemals selbst aufteilen.
python3 scripts/equalang.py text --file notes.md --to ja -o notes.ja.md

# Einen Auftrag erneut abfragen · einen abbrechen · den Kontostand · Sprachcodes (kein Schlüssel nötig)
python3 scripts/equalang.py status <job_id> -o ./out
python3 scripts/equalang.py cancel <job_id>
python3 scripts/equalang.py balance
python3 scripts/equalang.py languages chinese

Die Ausgabe lesen

Ein abgeschlossener Auftrag gibt outputs (jeweils mit path) und credits_charged aus. Teilen Sie dem Benutzer beides mit. Lesen Sie eine erzeugte Datei nicht zurück, um sie zusammenzufassen, es sei denn, Sie werden darum gebeten: Es handelt sich um ein ganzes Dokument, und der Sinn eines Pfades ist, dass sein Inhalt nicht in die Konversation gelangt.

Ein Fehler gibt {"error", "code", "retryable"} aus und beendet sich mit Exit-Code 1. Wiederholen Sie nur, wenn retryable wahr ist; INSUFFICIENT_CREDITS bedeutet, dass der Benutzer unter https://equalang.com/pricing Guthaben auflädt, nicht dass Sie es erneut versuchen.

Wissenswertes

• Formate. Dokumente: pdf, docx, pptx, xlsx, epub, html, txt. Untertitel: srt, vtt. Bilder: jpg, png, webp, bmp. Aufnahmen: mp3, m4a, wav, flac, ogg, aac, opus, mp4, mov, webm, mkv. Bis zu 100 MB. transcribe akzeptiert nur Aufnahmen.
• Ergebnisse überschreiben niemals. Sie landen neben einer lokalen Quelle (oder in -o VERZ, oder dem aktuellen Verzeichnis bei einer URL) unter dem Namen, den Equalang ihnen gibt; ein bereits vergebener Name erhält (1). Das erneute Abfragen von status bei einem abgeschlossenen Auftrag benennt die bereits geschriebenen Dateien, anstatt sie zu kopieren.
• Minuten, nicht Sekunden, bei langen Dateien. Der Befehl wartet und gibt Fortschritt auf stderr aus. Ein Unterbrechen bricht den Auftrag nicht ab: status <job_id> nimmt ihn wieder auf, cancel <job_id> stoppt ihn. Ein abgebrochener oder fehlgeschlagener Auftrag wird nicht berechnet.
• Eine Aufnahme wird nur für die tatsächlich hörbare Sprache berechnet – Stille und Musik nicht – daher kostet sie meist weniger als von estimate vorhergesagt; ein Dokument kostet, was estimate gesagt hat.
• Sprachcodes sehen aus wie en, zh-CN, zh-TW, ja, pt. Sie werden von der Live-API gelesen, niemals aus dem Speicher: languages listet diejenigen auf, die Dateien akzeptieren, languages --kind text die größere Menge, die text akzeptiert, und languages chinese findet eine Sprache anhand ihres Namens. Lassen Sie --source-language weg, um sie automatisch erkennen zu lassen.
• Mehrere Dateien? Schätzen Sie jede einzeln, addieren Sie die Zahlen und fragen Sie einmal – niemals einen Ordner auf eigene Faust durchlaufen.
• Die API dahinter, für alles, was das Skript nicht tut: https://equalang.com/llms.txt