Oversettelsesoppgave-API

Opprett oversettelsesoppgave

POST/v1/translation/create

Opprett en ny oversettelsesoppgave for dokument-/filoversettelse.

Fullstendig adresse: https://otranslator.com/api/v1/translation/create
Autentisering: API-nøkkelen må angis i Authorization-forespørselhodet
Content-Type: multipart/form-data
Feil format: { "error": "Invalid API key." }

Forsiktighetsregler

Opprettelse av oppgave vil umiddelbart gå inn i ventekøen og returnere taskId. Senere kan du hente fremdrift, kostnad og nedlastingslenke gjennom spørringsgrensesnittet for oppgaver.

Kontopoengsaldoen må være minst 2 credits for å opprette en oppgave. Når preview er true, genereres kun forhåndsvisning og forhåndsvisningspoeng betales.

glossary-parameteren matcher etter termbasenavn, og kan gjentas ved å sende inn flere felt med samme navn for å spesifisere flere termbaser.

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ørselsparametere

Parametere	Type	Standard	Beskrivelse	Eksempel
*file	binary	-	Fil som skal oversettes Støttede filtyper: forespørsel	bitcoin.pdf
*fromLang	String	-	Kildespråk, kildespråket kan ikke være det samme som målspråket Støttede språk: forespørsel	English
*toLang	String	-	Målspråk, målspråket kan ikke være det samme som kildespråket Støttede språk: forespørsel	Simplified Chinese
model	String	-	AI-modell for oversettelse Støttede modeller: forespørsel	-
fileDescription	String	-	Dokumentbeskrivelse - ved å gi ytterligere informasjon forbedres oversettelseskvaliteten, for eksempel ved å legge til ekstra dokumentbakgrunnsinformasjon og andre oversettelseskrav	-
glossary	String	-	Navn på ordliste brukt i oversettelsen	-
preview	Boolean	false	Om kun forhåndsvisning skal genereres. Ved kun generering av forhåndsvisning, betal 2 credits for å generere forhåndsvisning av dokumentoversettelsen	-
shouldTranslateImage	Boolean	false	Om bilder i dokumentet skal oversettes Støtter kun PDF / DOCX / PPTX / EPUB / ODS / ODT / ODF	-
forceOCR	Boolean	false	Tving bruk av OCR for å gjenkjenne dokumentinnhold. Når dette er aktivert, vil bildeoversettelse også bli aktivert.	-
shouldTranslateFileName	Boolean	true	Hvorvidt filnavn skal oversettes	-
strictSourceLanguageCheck	Boolean	false	Om kun tekst gjenkjent som originalspråket skal oversettes. Når dette er aktivert vil innhold som ikke er på kildespråket filtreres strengere, og kostnadsberegningen vil også bruke en strengere koeffisient.	-
outputFormat	String	-	Utdataformat. Ved innsending av MD vil systemet forsøke å generere Markdown-oversettelse.	MD
bilingualMode	String	Horizontal	Retning for oppsett av tospråklig fil. Horizontal viser side om side, Vertical viser over og under.	Horizontal
password	String	-	Åpningspassord for PDF-fil	-
ignoreComments	Boolean	false	Skal kommentarer i DOCX, PPTX og XLSX ignoreres	-
ignoreNotes	Boolean	false	Skal notater i PPTX ignoreres	-
ignoreHeadersAndFooters	Boolean	false	Skal bunntekst og topptekst i DOCX ignoreres	-
ignoreHidden	Boolean	false	Skal skjulte lysbilder i PPTX ignoreres	-
ignoreMasters	Boolean	false	Skal maler-tekst i PPTX ignoreres	-
ignoreSheetNames	Boolean	false	Om ikke å oversette XLSX-arknavn	-
extractTextRegExpPattern	String	-	Oversett kun innhold som matcher regulære uttrykk, og erstatt det med oversettelsen Støtter kun txmsg	-
extractTextRegExpFlags	String	-	Regulære uttrykks flags: g, s, m, u, y Støtter kun txmsg	-
allowFlip	Boolean	true	Hvorvidt det tillates å speilvende sidelayout for høyre-til-venstre-språk. Ved å sende inn false vil speilvending av bilder også slås av.	-
allowFlipImage	Boolean	true	Hvorvidt det tillates å speilvende bildeinnhold for høyre-til-venstre-språk.	-
webhookUrl	String	-	Callback-URL for statusoppdateringer, callback-innholdet inkluderer: {taskId, progress, status}	-

Svar

Parametere	Type	Standard	Beskrivelse	Eksempel
taskId	String	-	Oppgave-ID	-

Vanlige feil

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.