Traduction instantanée
Traduction brève du texte
Section intitulée « Traduction brève du texte »POST /api/v1/ai/translate-snippet{ "text": "Hello world", "source_lang": "auto", "target_lang": "zh", "engine": "xr-397b"}text est compris entre 1 et 5000 caractères. target_lang et source_lang (à l’exception de auto) doivent être des codes de langue pris en charge ; sinon, 422. Réponse :
{ "translated_text": "你好,世界", "source_lang": "auto", "target_lang": "zh" }Traduction segmentée par lots
Section intitulée « Traduction segmentée par lots »POST /api/v1/ai/translate-batch{ "segments": [ { "id": "p1", "text": "First paragraph." }, { "id": "p2", "text": "Second paragraph." } ], "target_lang": "zh"}segmentscontient 1 à 64 segments de 4000 caractères maximum chacun ; chaqueidest unique au sein de la requête (1 à 64 caractères). Trop de segments ou un segment trop long renvoie413.- La réponse renvoie
segments: [{ "id", "translated_text" }]dans l’ordre des requêtes. - Les segments ne contenant que des espaces sont renvoyés tels quels et ne sont pas facturés.
Conventions
Section intitulée « Conventions »- Le corps de la requête est limité à 2 Mo et une requête ne peut excéder 180 secondes ; configurez les délais d’attente du client sur au moins 180 secondes.
- Envoyez un
Idempotency-Key. Après une perte de connexion ou un délai d’attente dépassé, réessayez avec la même clé et le même corps ; aucune double facturation ne s’applique. - Un
engineindisponible renvoie400; si la clé possède des paramètres autorisés qui n’incluent pas celui choisi,403. - Facturé en fonction de la quantité de texte source effectivement traitée.
Reconnaissance de texte dans les images
Section intitulée « Reconnaissance de texte dans les images »POST /api/v1/ai/ocrTéléchargez l’image dans le champ file de multipart/form-data (PNG, JPEG, WebP, BMP, GIF, jusqu’à 12 Mo et 25 millions de pixels), ou envoyez l’image en tant que corps de la requête. La réponse renvoie le texte ligne par ligne avec les coordonnées des pixels :
{ "width": 640, "height": 240, "engine": "omnidoc-ocr", "blocks": [ { "text": "编号 INV-20261029-0042", "confidence": 0.97, "x": 23, "y": 76, "w": 366, "h": 33 } ]}xetysont les coordonnées du coin supérieur gauche de la ligne de texte, exprimées dans le système de coordonnées de l’image téléchargée (une JPEG contenant des données d’orientation est interprétée à la verticale).- Une boîte par ligne ;
confidencereprésente le niveau de confiance de la reconnaissance pour cette ligne (0–1). Si aucun texte n’est détecté, la réponse est200avec desblocksvides. - La reconnaissance de texte dans les images ne consomme aucun crédit. Les images dont la largeur ou la hauteur est inférieure à 11 pixels renvoient un résultat vide.
- Si la reconnaissance est temporairement indisponible, la réponse est
503; en cas de timeout, c’est504, avec une explication en chinois dansdetail; veuillez réessayer plus tard. - La connexion de l’extension de traduction web (
omnidoc.translate.use), les clés API et la connexion via le navigateur peuvent toutes l’appeler. - Les paramètres de requête
engine,sceneetlangsont conservés pour les anciennes versions de l’extension et n’affectent pas le résultat. - Pour obtenir directement des images traduites, téléchargez l’image et créez un travail de traduction.
Points terminaux retirés
Section intitulée « Points terminaux retirés »POST /api/v1/ai/notes, /ai/chat et /ai/generate sont obsolètes et renvoient 410.