Dokumentverzeichnis

Übersetzungsaufgaben-API

Übersetzter Text

POST/v1/translation/translateTexts

Übersetzen Sie den Text und geben Sie die Übersetzungsergebnisse synchron zurück.

Vollständige Adresse
https://otranslator.com/api/v1/translation/translateTexts
Authentifizierung
Der API Key muss im Authorization-Anfrage-Header übermittelt werden
Content-Type
application/json
Falsches Format
{ "error": "Invalid API key." }

Hinweise

Diese Schnittstelle speichert den eingegebenen Text temporär als JSON-Dokument und verarbeitet ihn synchron, geeignet für die sofortige Übersetzung kleiner Textmengen.

Das Kontoguthaben muss mindestens 2 credits betragen. Falls die tatsächlichen Kosten das Guthaben übersteigen, gibt die Schnittstelle taskId und price zurück und meldet unzureichendes Guthaben.

Beispiel

curl
1curl -X POST 'https://otranslator.com/api/v1/translation/translateTexts' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5  "texts": [
6    "string"
7  ],
8  "fromLang": "[string]",
9  "toLang": "[string]"
10}'

Anfrageparameter

ParameterTypStandardBeschreibungBeispiel
*textsString[]-

Zu übersetzender Text

-
*fromLangString-
  • Ausgangssprache, die Ausgangssprache darf nicht mit der Zielsprache identisch sein
  • Unterstützte Sprachen: Abfrage
-
*toLangString-
  • Zielsprache, die Zielsprache darf nicht mit der Ausgangssprache identisch sein
  • Unterstützte Sprachen: Abfrage
-
modelString-
  • KI-Modell für die Übersetzung
  • Unterstützte Modelle: Abfrage
-
fileDescriptionString-

Dokumentbeschreibung: Durch die Bereitstellung zusätzlicher Informationen wird die Übersetzungsqualität verbessert, beispielsweise durch Hinzufügung zusätzlicher Dokumenthintergrundinformationen und weiterer Übersetzungsanforderungen etc.

-

Antwort

ParameterTypStandardBeschreibungBeispiel
taskIdString-

Aufgaben-ID

-
translatedTextsString[]-

Übersetzter Text

-
priceInteger-

Gesamtanzahl der für die Übersetzung erforderlichen Credits

-
usedCreditsInteger-

Anzahl der von der Übersetzungsaufgabe verwendeten Credits

-

Häufige Fehler

401 Missing API key.

The Authorization request header is required.

401 Invalid API key.

The API key does not exist, has been deleted, or is no longer valid.

402 Insufficient credits balance.

The account does not have enough credits to translate the texts.

400 Missing required parameter: fromLang.

Provide fromLang using a language returned by /api/v1/languages.

400 Missing required parameter: toLang.

Provide toLang using a language returned by /api/v1/languages.

400 Missing required parameter: texts.

Provide a non-empty texts array.

400 Failed to translate texts.

The text translation task could not be processed.

Übersetzungsaufgaben-API
Übersetzungsaufgabe neu starten