Översättningsuppgift-API

Skapa översättningsuppgift

POST/v1/translation/create

Skapa en ny översättningsuppgift för dokument-/filöversättning.

Fullständig adress: https://otranslator.com/api/v1/translation/create
Autentisering: API-nyckeln behöver skickas i Authorization-förfrågningshuvudet
Content-Type: multipart/form-data
Felaktigt format: { "error": "Invalid API key." }

Att observera

Att skapa en uppgift läggs omedelbart till i väntkön och returnerar taskId. Därefter kan framsteg, kostnad och nedladdningslänk hämtas via uppgiftsgränssnittet.

Kontots kreditsaldo måste vara minst 2 credits för att skapa en uppgift. När preview är true genereras endast förhandsgranskning och förhandsgranskningskrediter debiteras.

Parametern glossary matchar efter ordlistans namn och kan upprepas genom att skicka in flera fält med samma namn för att specificera flera ordlistor.

Exempel

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'

Förfrågningsparametrar

Parametrar	Typ	Standard	Beskrivning	Exempel
*file	binary	-	Fil som ska översättas Filtyper som stöds: förfrågan	bitcoin.pdf
*fromLang	String	-	Källspråk, källspråket kan inte vara samma som målspråket Språk som stöds: fråga	English
*toLang	String	-	Målspråk, målspråket får inte vara samma som källspråket Språk som stöds: förfrågan	Simplified Chinese
model	String	-	AI-modell för översättning Modeller som stöds: förfrågan	-
fileDescription	String	-	Dokumentbeskrivning: genom att tillhandahålla ytterligare information förbättras översättningskvaliteten, till exempel genom att lägga till extra dokumentbakgrundsinformation och andra översättningskrav etc.	-
glossary	String	-	Namn på terminologilista som används vid översättning	-
preview	Boolean	false	Om endast förhandsvisning ska genereras. När endast förhandsvisning genereras, betala 2 credits för att generera en förhandsvisning av dokumentöversättningen	-
shouldTranslateImage	Boolean	false	Om bilder i dokumentet ska översättas Stöder endast PDF / DOCX / PPTX / EPUB / ODS / ODT / ODF	-
forceOCR	Boolean	false	Framtvinga OCR för att identifiera dokumentinnehåll. När aktiverad kommer bildöversättning också att aktiveras.	-
shouldTranslateFileName	Boolean	true	Ska filnamn översättas	-
strictSourceLanguageCheck	Boolean	false	Om endast text som identifieras som källspråk ska översättas. När aktiverat filtreras innehåll som inte är på källspråket strängare, och en strängare koefficient används för avgiftsberäkningen.	-
outputFormat	String	-	Utdataformat. När MD skickas in görs ett försök att generera Markdown-översättning.	MD
bilingualMode	String	Horizontal	Layoutriktning för tvåspråkig fil. Horizontal betyder sida vid sida, Vertical betyder över och under.	Horizontal
password	String	-	Lösenord för att öppna PDF-filen	-
ignoreComments	Boolean	false	Ska kommentarer i DOCX, PPTX och XLSX ignoreras	-
ignoreNotes	Boolean	false	Ska anteckningar i PPTX ignoreras	-
ignoreHeadersAndFooters	Boolean	false	Ska sidhuvuden och sidfötter i DOCX ignoreras	-
ignoreHidden	Boolean	false	Ska dolda sidor i PPTX ignoreras	-
ignoreMasters	Boolean	false	Ska malltext i PPTX ignoreras	-
ignoreSheetNames	Boolean	false	Om XLSX-arknamn inte ska översättas	-
extractTextRegExpPattern	String	-	Översätt endast innehåll som matchar reguljära uttryck och ersätt det med översättningen Stöder endast txmsg	-
extractTextRegExpFlags	String	-	Reguljära uttrycks flaggor: g, s, m, u, y Stöder endast txmsg	-
allowFlip	Boolean	true	Om vändning av sidlayout ska tillåtas för höger-till-vänster-språk. Vid värdet false stängs även bildvändning av.	-
allowFlipImage	Boolean	true	Om vändning av bildinnehåll ska tillåtas för höger-till-vänster-språk.	-
webhookUrl	String	-	Callback-URL för statusuppdateringar, callback-innehållet inkluderar: {taskId, progress, status}	-

Svar

Parametrar	Typ	Standard	Beskrivning	Exempel
taskId	String	-	Uppgifts-ID	-

Vanliga fel

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.