API Εργασιών Μετάφρασης

Δημιουργία εργασίας μετάφρασης

POST/v1/translation/create

Δημιουργήστε μια νέα εργασία μετάφρασης για μετάφραση εγγράφου/αρχείου.

Πλήρης διεύθυνση: https://otranslator.com/api/v1/translation/create
Πιστοποίηση: Απαιτείται η μετάδοση του API Key στην επικεφαλίδα αιτήματος Authorization
Content-Type: multipart/form-data
Λανθασμένη μορφή: { "error": "Invalid API key." }

Σημεία προσοχής

Η δημιουργία εργασίας εισέρχεται αμέσως στην ουρά αναμονής και επιστρέφει το taskId. Στη συνέχεια μπορείτε να λάβετε την πρόοδο, το κόστος και τον σύνδεσμο λήψης μέσω της διεπαφής ερωτήματος εργασίας.

Το υπόλοιπο πιστώσεων του λογαριασμού πρέπει να είναι τουλάχιστον 2 credits για να δημιουργηθεί μια εργασία. Όταν το preview είναι true, δημιουργείται μόνο προεπισκόπηση και καταβάλλονται οι πιστώσεις προεπισκόπησης.

Η παράμετρος glossary αντιστοιχίζεται με βάση το όνομα του γλωσσαρίου και μπορεί να περαστεί επανειλημμένα με πολλαπλά ομώνυμα πεδία για τον καθορισμό πολλαπλών γλωσσαρίων.

Παράδειγμα

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'

Παράμετροι Αιτήματος

Παράμετροι	Τύπος	Προεπιλογή	Περιγραφή	Παράδειγμα
*file	binary	-	Αρχείο προς μετάφραση Υποστηριζόμενοι τύποι αρχείων: ερώτημα	bitcoin.pdf
*fromLang	String	-	Γλώσσα προέλευσης, η γλώσσα προέλευσης δεν μπορεί να είναι ίδια με τη γλώσσα προορισμού Υποστηριζόμενες γλώσσες: ερώτημα	English
*toLang	String	-	Γλώσσα προορισμού, η γλώσσα προορισμού δεν μπορεί να είναι ίδια με την αρχική γλώσσα Υποστηριζόμενες γλώσσες: ερώτημα	Simplified Chinese
model	String	-	Μοντέλο AI μετάφρασης Υποστηριζόμενα μοντέλα: ερώτημα	-
fileDescription	String	-	Περιγραφή εγγράφου: βελτιώστε την ποιότητα της μετάφρασης παρέχοντας πρόσθετες πληροφορίες, όπως προσθήκη επιπλέον πληροφοριών υποβάθρου εγγράφου και άλλες απαιτήσεις μετάφρασης κ.λπ.	-
glossary	String	-	Όνομα γλωσσαρίου που χρησιμοποιείται για τη μετάφραση	-
preview	Boolean	false	Δημιουργία μόνο προεπισκόπησης. Κατά τη δημιουργία μόνο προεπισκόπησης, πληρώστε 2 credits για να δημιουργήσετε προεπισκόπηση της μετάφρασης εγγράφου	-
shouldTranslateImage	Boolean	false	Αν θα μεταφραστούν οι εικόνες του εγγράφου Υποστηρίζει μόνο PDF / DOCX / PPTX / EPUB / ODS / ODT / ODF	-
forceOCR	Boolean	false	Αναγκαστική χρήση OCR για αναγνώριση περιεχομένου εγγράφου. Μετά την ενεργοποίηση θα ενεργοποιηθεί ταυτόχρονα και η μετάφραση εικόνων.	-
shouldTranslateFileName	Boolean	true	Να μεταφραστεί το όνομα αρχείου	-
strictSourceLanguageCheck	Boolean	false	Να μεταφράζεται μόνο το κείμενο που αναγνωρίζεται ως γλώσσα πηγής. Όταν είναι ενεργοποιημένο, θα φιλτράρεται πιο αυστηρά το περιεχόμενο εκτός γλώσσας πηγής και ο υπολογισμός χρέωσης θα χρησιμοποιεί επίσης αυστηρότερο συντελεστή.	-
outputFormat	String	-	Μορφή εξόδου. Όταν περάσει MD, θα επιχειρηθεί η δημιουργία μετάφρασης Markdown.	MD
bilingualMode	String	Horizontal	Κατεύθυνση διάταξης δίγλωσσου αρχείου. Horizontal σημαίνει αντιπαραβολή αριστερά-δεξιά, Vertical σημαίνει αντιπαραβολή πάνω-κάτω.	Horizontal
password	String	-	Κωδικός πρόσβασης ανοίγματος αρχείου PDF	-
ignoreComments	Boolean	false	Αγνόηση σχολίων σε DOCX, PPTX και XLSX αρχεία	-
ignoreNotes	Boolean	false	Αγνόηση σημειώσεων σε PPTX αρχεία	-
ignoreHeadersAndFooters	Boolean	false	Αγνόηση υποσέλιδων και κεφαλίδων σε DOCX αρχεία	-
ignoreHidden	Boolean	false	Αγνόηση κρυφών σελίδων σε PPTX αρχεία	-
ignoreMasters	Boolean	false	Αγνόηση κειμένου προτύπων σε PPTX αρχεία	-
ignoreSheetNames	Boolean	false	Εάν δεν θα μεταφραστούν τα ονόματα φύλλων του XLSX	-
extractTextRegExpPattern	String	-	Μετάφραση μόνο περιεχομένου που ταιριάζει με κανονικές εκφράσεις και αντικατάστασή του με τη μετάφραση Υποστηρίζει μόνο txmsg	-
extractTextRegExpFlags	String	-	Flags των κανονικών εκφράσεων: g, s, m, u, y Υποστηρίζει μόνο txmsg	-
allowFlip	Boolean	true	Να επιτρέπεται η αναστροφή της διάταξης σελίδας για γλώσσες από δεξιά προς αριστερά. Το false απενεργοποιεί ταυτόχρονα και την αναστροφή εικόνων.	-
allowFlipImage	Boolean	true	Να επιτρέπεται η αναστροφή του περιεχομένου εικόνας για γλώσσες από δεξιά προς αριστερά.	-
webhookUrl	String	-	URL callback κατά την ενημέρωση κατάστασης, το περιεχόμενο του callback περιλαμβάνει: {taskId, progress, status}	-

Απάντηση

Παράμετροι	Τύπος	Προεπιλογή	Περιγραφή	Παράδειγμα
taskId	String	-	Αναγνωριστικό εργασίας	-

Συνήθη σφάλματα

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.