Directe vertaling
Korte tekstvertaling
Section titled “Korte tekstvertaling”POST /api/v1/ai/translate-snippet{ "text": "Hello world", "source_lang": "auto", "target_lang": "zh", "engine": "xr-397b"}text is 1–5000 tekens. target_lang en source_lang (anders dan auto) moeten ondersteunde taalcodes zijn, anders 422. Antwoord:
{ "translated_text": "你好,世界", "source_lang": "auto", "target_lang": "zh" }Batchsegmentvertaling
Section titled “Batchsegmentvertaling”POST /api/v1/ai/translate-batch{ "segments": [ { "id": "p1", "text": "First paragraph." }, { "id": "p2", "text": "Second paragraph." } ], "target_lang": "zh"}segmentsbevat 1–64 segmenten van maximaal 4000 tekens elk; elkidis uniek binnen het verzoek (1–64 tekens). Te veel segmenten of een te lang segment retourneert413.- Het antwoord geeft
segments: [{ "id", "translated_text" }]in de oorspronkelijke volgorde van het verzoek terug. - Segmenten die uitsluitend leestekens bevatten, worden ongewijzigd geretourneerd en niet in rekening gebracht.
Conventies
Section titled “Conventies”- De request-body is beperkt tot 2 MB en een request duurt maximaal 180 seconden; stel client-timeouts in op minimaal 180 seconden.
- Stuur een
Idempotency-Key. Na een netwerkonderbreking of time-out, probeer het opnieuw met dezelfde sleutel en dezelfde body; er worden geen dubbele kosten in rekening gebracht. - Een niet-beschikbare
engineretourneert400; als de sleutel toegestane instellingen heeft die de gekozen instelling niet bevatten,403. - Berekend op basis van de hoeveelheid bron tekst die daadwerkelijk is verwerkt.
Tekstherkenning in afbeeldingen
Section titled “Tekstherkenning in afbeeldingen”POST /api/v1/ai/ocrUpload de afbeelding in het veld file van multipart/form-data (PNG, JPEG, WebP, BMP, GIF, maximaal 12 MB en 25 miljoen pixels), of stuur de afbeelding als de verzoeksbody. Het antwoord geeft de tekst regel voor regel met pixelcoördinaten:
{ "width": 640, "height": 240, "engine": "omnidoc-ocr", "blocks": [ { "text": "编号 INV-20261029-0042", "confidence": 0.97, "x": 23, "y": 76, "w": 366, "h": 33 } ]}xenyzijn de linkerbovenhoek van de tekstregel, in de coördinaten van de geüploade afbeelding (een JPEG met oriëntatiegegevens wordt rechtop gelezen).- Eén vak per regel;
confidenceis de herkenningsbetrouwbaarheid van die regel (0–1). Als er geen tekst wordt gevonden, is het antwoord200met legeblocks. - Tekstherkenning in afbeeldingen kost geen credits. Afbeeldingen die minder dan 11 pixels breed of hoog zijn, leveren een leeg resultaat op.
- Als herkenning tijdelijk niet beschikbaar is, is de respons
503; bij time-out504, met een Chinese uitleg indetail; probeer het later opnieuw. - De aanmelding (
omnidoc.translate.use) van de webvertalingsextensie, API-sleutels en browseraanmelding kunnen er allemaal aanspraak op maken. - De queryparameters
engine,sceneenlangworden bewaard voor oudere extensieversies en hebben geen invloed op het resultaat. - Om rechtstreeks vertaalde afbeeldingen te verkrijgen, uploadt u de afbeelding en maakt u een vertaalopdracht .
Gepensioneerde eindpunten
Section titled “Gepensioneerde eindpunten”POST /api/v1/ai/notes, /ai/chat en /ai/generate zijn uit de roulatie genomen en retourneren 410.