Übersetzungs-API
Senden Sie Ihre eigenen Dokumente per Skript an Edgepedia Übersetzen und erhalten Sie die Übersetzungen zurück. Es ist derselbe Dienst wie auf der Seite „Übersetzen“, zu denselben Preisen und mit Bezahlung aus demselben Credit-Guthaben.
Einen Schlüssel erstellen
Erstellen Sie einen Schlüssel auf der Seite „Übersetzen“: Melden Sie sich an, öffnen Sie oben rechts Ihr Konto und wählen Sie unter „API-Schlüssel“ die Option „Erstellen“.
Senden Sie den Schlüssel bei jeder Anfrage als Authorization: Bearer ept_… mit. Halten Sie ihn geheim: Wer ihn besitzt, kann Ihre Credits ausgeben.
Preise
- Standard: 1 Credit pro 250 Wörter (mindestens 1).
- Pro: 1 Credit pro 75 Wörter (mindestens 2).
- Bei Übersetzungen zwischen zwei Sprachen, von denen keine Englisch ist, verdoppelt sich der Preis.
- 100 Credits = 1 USD.
Bei einer fehlgeschlagenen Übersetzung werden die Credits erstattet.
Endpunkte
Basis-URL: https://translate.edgepedia.ai. Anfragen und Antworten verwenden JSON; ein Fehler wird als {"error": "…"} zurückgegeben.
GET /api/v1/languages
Die Sprachen mit der jeweiligen Angabe, ob Pro verfügbar ist.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/languages
GET /api/v1/balance
Ihr Credit-Guthaben.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/balance
POST /api/v1/quote
Preis und voraussichtliche Dauer einer Übersetzung, ohne sie zu starten. mode ist standard oder pro.
Eine Preisanfrage akzeptiert auch "source": "auto": Die Antwort gibt mit "detected": true die in "source" erkannte Sprache an. Mit diesem Sprachcode starten Sie dann die Übersetzung.
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard"}' \
https://translate.edgepedia.ai/api/v1/quote
POST /api/v1/translations
Starten Sie die Übersetzung eines Textes oder einer .txt-, .md-, .docx- oder .pdf-Datei mit bis zu 10 MB. Fügen Sie "expect_credits" hinzu, damit die Anfrage abgelehnt wird (409), wenn der Preis vom erwarteten Preis abweicht. Fügen Sie "wait" hinzu (bis zu 120 Sekunden), um die fertige Übersetzung in derselben Antwort zu erhalten.
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard", "wait": 60}' \
https://translate.edgepedia.ai/api/v1/translations
curl -H "Authorization: Bearer $KEY" -F file=@report.docx -F source=en -F target=ar -F mode=standard \
https://translate.edgepedia.ai/api/v1/translations
GET /api/v1/translations/{id}
Der Status einer Übersetzung (queued, running, done oder failed) und nach Abschluss ihr Text. Bei einem Fehlschlag wird der Grund angegeben. Eine fertige Übersetzung kann 30 Tage lang abgerufen werden.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations/$ID
GET /api/v1/translations/{id}/download
Das Ergebnis einer Dateiübersetzung: eine .docx-Datei für .docx- und .pdf-Dateien, Text für .txt und .md.
curl -H "Authorization: Bearer $KEY" -o translated.docx https://translate.edgepedia.ai/api/v1/translations/$ID/download
GET /api/v1/translations
Ihre Übersetzungen, die neuesten zuerst, maximal 50.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations
Statuscodes
| Code | Bedeutung |
|---|---|
| 200 | OK; bei einem Start mit wait ist die Übersetzung abgeschlossen oder fehlgeschlagen. |
| 202 | Gestartet oder nach wait noch in Bearbeitung. |
| 400 | Die Anfrage kann in dieser Form nicht übersetzt werden; die Fehlermeldung nennt den Grund. |
| 401 | Fehlender, unbekannter oder widerrufener Schlüssel. |
| 402 | Nicht genügend Credits. |
| 404 | In Ihrem Konto gibt es keine solche Übersetzung. |
| 409 | Der Preis entspricht nicht Ihrem expect_credits; es wurde nichts abgebucht. |
| 413 | Die Datei ist größer als 10 MB. |
| 429 | Mehr als 60 Anfragen innerhalb einer Minute; versuchen Sie es nach der in Retry-After angegebenen Anzahl von Sekunden erneut. |