Ga naar inhoud

Directe vertaling

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" }
POST /api/v1/ai/translate-batch
{
"segments": [
{ "id": "p1", "text": "First paragraph." },
{ "id": "p2", "text": "Second paragraph." }
],
"target_lang": "zh"
}
  • segments bevat 1–64 segmenten van maximaal 4000 tekens elk; elk id is uniek binnen het verzoek (1–64 tekens). Te veel segmenten of een te lang segment retourneert 413.
  • 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.
  • 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 engine retourneert 400; 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.
POST /api/v1/ai/ocr

Upload 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 }
]
}
  • x en y zijn 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; confidence is de herkenningsbetrouwbaarheid van die regel (0–1). Als er geen tekst wordt gevonden, is het antwoord 200 met lege blocks.
  • 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-out 504, met een Chinese uitleg in detail; 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, scene en lang worden 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 .

POST /api/v1/ai/notes, /ai/chat en /ai/generate zijn uit de roulatie genomen en retourneren 410.