Sofortige Übersetzung
Kurze Textübersetzung
Abschnitt betitelt „Kurze Textü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" }Batch-Segmentübersetzung
Abschnitt betitelt „Batch-Segmentübersetzung“POST /api/v1/ai/translate-batch{ "segments": [ { "id": "p1", "text": "First paragraph." }, { "id": "p2", "text": "Second paragraph." } ], "target_lang": "zh"}segmentsenthält 1–64 Segmente mit jeweils höchstens 4000 Zeichen; jedesidist innerhalb der Anfrage eindeutig (1–64 Zeichen). Zu viele Segmente oder ein zu langes Segment führen zur Rückgabe von413.- 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.
Konventionen
Abschnitt betitelt „Konventionen“- 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
enginegibt400zurü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.
Bildtexterkennung
Abschnitt betitelt „Bildtexterkennung“POST /api/v1/ai/ocrLaden 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 } ]}xundysind die linke obere Ecke der Textzeile in den Koordinaten des hochgeladenen Bildes (ein JPEG mit Orientierungsdaten wird aufrecht gelesen).- Eine Box pro Zeile;
confidenceist die Erkennungssicherheit dieser Zeile (0–1). Wird kein Text gefunden, lautet die Antwort200mit leerenblocks. - 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überschreitung504und mit einer chinesischen Erklärung indetail; 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,sceneundlangwerden 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 .
Eingestellte Endpunkte
Abschnitt betitelt „Eingestellte Endpunkte“POST /api/v1/ai/notes, /ai/chat und /ai/generate sind eingestellt und geben 410 zurück.