Oversættelsesopgave API

Opret oversættelsesopgave

POST/v1/translation/create

Opret en ny oversættelsesopgave til dokument-/filoversættelse.

Fuld adresse: https://otranslator.com/api/v1/translation/create
Autentificering: API Key skal angives i Authorization-anmodningsheaderen
Content-Type: multipart/form-data
Forkert format: { "error": "Invalid API key." }

Forholdsregler

Oprettelse af en opgave vil straks gå ind i ventekøen og returnere taskId. Efterfølgende kan fremskridt, omkostninger og downloadlink hentes via opgaveforespørgsels-interfacet.

Kontosaldoen skal være mindst 2 credits for at oprette en opgave. Når preview er true, genereres kun forhåndsvisning og der betales for forhåndsvisningspoint.

glossary-parameteren matcher efter ordlistenavne og kan sendes ind gentagne gange med flere felter med samme navn for at angive flere ordlister.

Eksempel

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'

Forespørgselsparametre

Parametre	Type	Standard	Beskrivelse	Eksempel
*file	binary	-	Fil der skal oversættes Understøttede filtyper: forespørgsel	bitcoin.pdf
*fromLang	String	-	Kildesprog, kildesproget kan ikke være identisk med målsproget Understøttede sprog: forespørgsel	English
*toLang	String	-	Målsprog, målsproget kan ikke være identisk med kildesproget Understøttede sprog: forespørgsel	Simplified Chinese
model	String	-	AI-model til oversættelse Understøttede modeller: forespørgsel	-
fileDescription	String	-	Dokumentbeskrivelse: ved at tilføje yderligere information forbedres oversættelseskvaliteten, for eksempel ekstra dokumentbaggrundsinformation og andre oversættelseskrav	-
glossary	String	-	Navn på terminologiliste anvendt til oversættelse	-
preview	Boolean	false	Om der kun skal genereres forhåndsvisning. Ved kun at generere forhåndsvisning kan du få en forhåndsvisning af dokumentoversættelsen ved at betale 2 credits	-
shouldTranslateImage	Boolean	false	Om billeder i dokumentet skal oversættes Understøtter kun PDF / DOCX / PPTX / EPUB / ODS / ODT / ODF	-
forceOCR	Boolean	false	Skal OCR tvinges til genkendelse af dokumentindhold. Ved aktivering vil billedoversættelse også blive aktiveret.	-
shouldTranslateFileName	Boolean	true	Hvorvidt filnavne skal oversættes	-
strictSourceLanguageCheck	Boolean	false	Hvorvidt kun tekst, der genkendes som originalsproget, skal oversættes. Når aktiveret filtreres indhold på andre sprog end kildesproget strengere, og omkostningsberegningen vil også bruge en strengere koefficient.	-
outputFormat	String	-	Outputformat. Ved indtastning af MD forsøges der at generere Markdown-oversættelse.	MD
bilingualMode	String	Horizontal	Layoutretning for tosprogede filer. Horizontal betyder ved siden af hinanden, Vertical betyder over og under hinanden.	Horizontal
password	String	-	Åbningsadgangskode for PDF-fil	-
ignoreComments	Boolean	false	Hvorvidt kommentarer i DOCX, PPTX og XLSX skal ignoreres	-
ignoreNotes	Boolean	false	Hvorvidt noter i PPTX skal ignoreres	-
ignoreHeadersAndFooters	Boolean	false	Hvorvidt sidefod og sidehoved i DOCX skal ignoreres	-
ignoreHidden	Boolean	false	Hvorvidt skjulte slides i PPTX skal ignoreres	-
ignoreMasters	Boolean	false	Hvorvidt mastertekst i PPTX skal ignoreres	-
ignoreSheetNames	Boolean	false	Om ikke at oversætte XLSX-arknavne	-
extractTextRegExpPattern	String	-	Oversæt kun indhold der matcher regulære udtryk, og erstat det med oversættelsen Understøtter kun txmsg	-
extractTextRegExpFlags	String	-	Flags for regulære udtryk: g, s, m, u, y Understøtter kun txmsg	-
allowFlip	Boolean	true	Hvorvidt sidelayout må spejlvendes for højre-til-venstre-sprog. Ved angivelse af false deaktiveres billedspejlvending samtidig.	-
allowFlipImage	Boolean	true	Hvorvidt billedindhold må spejlvendes for højre-til-venstre-sprog.	-
webhookUrl	String	-	Callback URL ved statusopdateringer, callback-indholdet omfatter: {taskId, progress, status}	-

Svar

Parametre	Type	Standard	Beskrivelse	Eksempel
taskId	String	-	Opgave-ID	-

Almindelige fejl

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.