API de tâche de traduction

Créer une tâche de traduction

POST/v1/translation/create

Créer une nouvelle tâche de traduction pour la traduction de document/fichier.

Adresse complète: https://otranslator.com/api/v1/translation/create
Authentification: Il est nécessaire de transmettre la clé API dans l'en-tête de requête Authorization
Content-Type: multipart/form-data
Format erroné: { "error": "Invalid API key." }

Points à noter

La création d'une tâche entre immédiatement dans la file d'attente et renvoie un taskId. Par la suite, il est possible d'obtenir la progression, les frais et le lien de téléchargement via l'interface de requête de tâches.

Le solde de crédits du compte doit être d'au moins 2 credits pour créer une tâche. Lorsque preview est true, seul un aperçu est généré et les crédits d'aperçu sont débités.

Le paramètre glossary correspond au nom du glossaire et peut être transmis plusieurs fois sous le même nom de champ pour spécifier plusieurs glossaires.

Exemple

curl

1curl -X POST 'https://otranslator.com/api/v1/translation/create' \
2--header 'Authorization: [yourSecretKey]' \
3--form 'file=@bitcoin.pdf' \
4--form 'fromLang=English' \
5--form 'toLang=Simplified Chinese' \
6--form 'outputFormat=MD' \
7--form 'bilingualMode=Horizontal'

Paramètres de requête

Paramètres	Type	Par défaut	Description	Exemple
*file	binary	-	Fichier à traduire Types de fichiers pris en charge : consulter	bitcoin.pdf
*fromLang	String	-	Langue source, la langue source ne peut pas être identique à la langue cible Langues prises en charge : consulter	English
*toLang	String	-	Langue cible, la langue cible ne peut pas être identique à la langue source Langues prises en charge : consulter	Simplified Chinese
model	String	-	Modèle d'IA de traduction Modèles pris en charge : consulter	-
fileDescription	String	-	Description du document : améliorer la qualité de la traduction en fournissant des informations supplémentaires, par exemple en ajoutant des informations contextuelles supplémentaires sur le document et d'autres exigences de traduction, etc.	-
glossary	String	-	Nom du glossaire utilisé pour la traduction	-
preview	Boolean	false	Générer uniquement un aperçu. Lors de la génération d'un aperçu uniquement, payer 2 crédits pour générer un aperçu de la traduction du document	-
shouldTranslateImage	Boolean	false	Indique s'il convient de traduire les images du document Prend en charge uniquement PDF / DOCX / PPTX / EPUB / ODS / ODT / ODF	-
forceOCR	Boolean	false	Forcer l'utilisation de l'OCR pour reconnaître le contenu du document. Si activé, cela activera également la traduction d'images.	-
shouldTranslateFileName	Boolean	true	Traduire le nom de fichier	-
strictSourceLanguageCheck	Boolean	false	Traduire uniquement le texte reconnu comme étant dans la langue d'origine ?Une fois activé, le filtrage du contenu hors langue source sera plus strict, et un coefficient plus strict sera également appliqué pour le calcul des frais.	-
outputFormat	String	-	Format de sortie. Lors de la transmission de MD, une tentative de génération d'une traduction Markdown sera effectuée.	MD
bilingualMode	String	Horizontal	Sens de mise en page du fichier bilingue. Horizontal indique une mise en regard gauche-droite, Vertical indique une mise en regard haut-bas.	Horizontal
password	String	-	Mot de passe d'ouverture du fichier PDF	-
ignoreComments	Boolean	false	Ignorer les commentaires des fichiers DOCX, PPTX et XLSX	-
ignoreNotes	Boolean	false	Ignorer les notes des fichiers PPTX	-
ignoreHeadersAndFooters	Boolean	false	Ignorer les en-têtes et pieds de page des fichiers DOCX	-
ignoreHidden	Boolean	false	Ignorer les diapositives masquées PPTX	-
ignoreMasters	Boolean	false	Ignorer le texte des masques PPTX	-
ignoreSheetNames	Boolean	false	Ne pas traduire les noms de feuilles XLSX	-
extractTextRegExpPattern	String	-	Traduire uniquement le contenu correspondant à l'expression régulière et le remplacer par la traduction Prend en charge uniquement txmsg	-
extractTextRegExpFlags	String	-	Indicateurs des expressions régulières : g, s, m, u, y Prend uniquement en charge txmsg	-
allowFlip	Boolean	true	Autoriser le retournement de la mise en page pour les langues de droite à gauche. Le passage de false désactive également le retournement des images.	-
allowFlipImage	Boolean	true	Autoriser le retournement du contenu des images pour les langues de droite à gauche.	-
webhookUrl	String	-	URL de rappel lors de la mise à jour du statut, le contenu du rappel inclut : {taskId, progress, status}	-

Réponse

Paramètres	Type	Par défaut	Description	Exemple
taskId	String	-	ID de tâche	-

Erreurs courantes

401 Missing API key.

The Authorization request header is required.

401 Invalid API key.

The API key does not exist, has been deleted, or is no longer valid.

402 Insufficient credits balance.

The account does not have enough credits to create the task.

400 Missing required parameter: fromLang.

Provide fromLang using a language returned by /api/v1/languages.

400 Missing required parameter: toLang.

Provide toLang using a language returned by /api/v1/languages.

400 Invalid fromLang: [language]. Use a language returned by /api/v1/languages.

The provided source language is not supported.

400 Invalid toLang: [language]. Use a language returned by /api/v1/languages.

The provided target language is not supported.

400 Missing required file upload: file.

Upload the source document in the file form field.

404 Glossary "[name]" not found.

The specified glossary does not exist or does not belong to the current API account.