Zum Inhalt springen

Sofortige Übersetzung

POST /api/v1/ai/translate-snippet
{
"text": "Hello world",
"source_lang": "auto",
"target_lang": "zh",
"engine": "xr-397b"
}

text umfasst 1–5000 Zeichen. target_lang und source_lang (außer auto) müssen unterstützte Sprachcodes sein, andernfalls gilt 422. Antwort:

{ "translated_text": "你好,世界", "source_lang": "auto", "target_lang": "zh" }
POST /api/v1/ai/translate-batch
{
"segments": [
{ "id": "p1", "text": "First paragraph." },
{ "id": "p2", "text": "Second paragraph." }
],
"target_lang": "zh"
}
  • segments enthält 1–64 Segmente mit jeweils höchstens 4000 Zeichen; jedes id ist innerhalb der Anfrage eindeutig (1–64 Zeichen). Zu viele Segmente oder ein zu langes Segment führen zur Rückgabe von 413.
  • Die Antwort gibt segments: [{ "id", "translated_text" }] in der Anforderungsreihenfolge zurück.
  • Segmente, die ausschließlich Leerzeichen enthalten, werden unverändert zurückgegeben und nicht berechnet.
  • Der Anfragetext ist auf 2 MB begrenzt und eine Anfrage darf höchstens 180 Sekunden dauern; setzen Sie die Client-Timeouts auf mindestens 180 Sekunden.
  • Senden Sie einen Idempotency-Key. Nach einem Netzwerkfehler oder Timeout versuchen Sie es erneut mit demselben Schlüssel und demselben Body; es fallen keine doppelten Gebühren an.
  • Ein nicht verfügbarer engine gibt 400 zurück; falls der Schlüssel zulässige Einstellungen enthält, die die gewählte nicht einschließen, 403.
  • Abgerechnet wird nach der tatsächlich verarbeiteten Quelltextmenge.
POST /api/v1/ai/ocr

Laden Sie das Bild im Feld file von multipart/form-data (PNG, JPEG, WebP, BMP, GIF, bis zu 12 MB und 25 Millionen Pixel) hoch oder senden Sie das Bild als Anfragekörper. Die Antwort gibt den Text Zeile für Zeile zusammen mit den Pixelkoordinaten zurück:

{
"width": 640,
"height": 240,
"engine": "omnidoc-ocr",
"blocks": [
{ "text": "编号 INV-20261029-0042", "confidence": 0.97, "x": 23, "y": 76, "w": 366, "h": 33 }
]
}
  • x und y sind die linke obere Ecke der Textzeile in den Koordinaten des hochgeladenen Bildes (ein JPEG mit Orientierungsdaten wird aufrecht gelesen).
  • Eine Box pro Zeile; confidence ist die Erkennungssicherheit dieser Zeile (0–1). Wird kein Text gefunden, lautet die Antwort 200 mit leeren blocks.
  • Die Bildtexterkennung kostet keine Credits. Bilder, die weniger als 11 Pixel breit oder hoch sind, liefern ein leeres Ergebnis.
  • Wenn die Erkennung vorübergehend nicht verfügbar ist, lautet die Antwort 503, bei Zeitüberschreitung 504 und mit einer chinesischen Erklärung in detail; bitte später erneut versuchen.
  • Die Anmeldung der Web-Übersetzungserweiterung (omnidoc.translate.use), API-Schlüssel und Browser-Anmeldung können alle darauf zugreifen.
  • Die Abfrageparameter engine, scene und lang werden für ältere Erweiterungsversionen beibehalten und haben keinen Einfluss auf das Ergebnis.
  • Um übersetzte Bilder direkt zu erhalten, laden Sie das Bild hoch und erstellen Sie einen Übersetzungsauftrag .

POST /api/v1/ai/notes, /ai/chat und /ai/generate sind eingestellt und geben 410 zurück.