Aller au contenu

Traduction instantanée

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" }
POST /api/v1/ai/translate-batch
{
"segments": [
{ "id": "p1", "text": "First paragraph." },
{ "id": "p2", "text": "Second paragraph." }
],
"target_lang": "zh"
}
  • segments contient 1 à 64 segments de 4000 caractères maximum chacun ; chaque id est unique au sein de la requête (1 à 64 caractères). Trop de segments ou un segment trop long renvoie 413.
  • 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.
  • 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 engine indisponible renvoie 400 ; 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.
POST /api/v1/ai/ocr

Té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 }
]
}
  • x et y sont 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 ; confidence représente le niveau de confiance de la reconnaissance pour cette ligne (0–1). Si aucun texte n’est détecté, la réponse est 200 avec des blocks vides.
  • 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’est 504, avec une explication en chinois dans detail ; 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, scene et lang sont 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.

POST /api/v1/ai/notes, /ai/chat et /ai/generate sont obsolètes et renvoient 410.