Fordítási Feladat API

Fordítási feladat létrehozása

POST/v1/translation/create

Új fordítási feladat létrehozása dokumentum/fájl fordításhoz.

Teljes cím: https://otranslator.com/api/v1/translation/create
Hitelesítés: Az API kulcsot az Authorization kérésfejlécben kell átadni
Content-Type: multipart/form-data
Hibás formátum: { "error": "Invalid API key." }

Tudnivalók

A feladat létrehozása azonnal a várakozási sorba kerül, és visszaadja a taskId-t. Ezt követően a feladat lekérdezési felületen keresztül kérhető le az előrehaladás, a költség és a letöltési link.

A fiók pontegyenlegének legalább 2 credits szükséges a feladat létrehozásához. Ha preview true értékű, csak előnézet generálódik és az előnézeti pontok kerülnek felhasználásra.

A glossary paraméter szószedet név szerint egyezik, több szószedet megadásához ugyanazon nevű mező többször is átadható.

Példa

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'

Kérés Paraméterei

Paraméterek	Típus	Alapértelmezett	Leírás	Példa
*file	binary	-	Fordítandó fájl Támogatott fájltípusok: lekérdezés	bitcoin.pdf
*fromLang	String	-	Forrásnyelv, a forrásnyelv nem lehet azonos a célnyelvvel Támogatott nyelvek: lekérdezés	English
*toLang	String	-	Célnyelv, a célnyelv nem lehet azonos a forrásnyelvel Támogatott nyelvek: lekérdezés	Simplified Chinese
model	String	-	A fordítás AI modellje Támogatott modellek: lekérdezés	-
fileDescription	String	-	Dokumentum leírása: további információk biztosításával javítja a fordítás minőségét, például kiegészítő dokumentum-háttérinformációk és egyéb fordítási követelmények megadásával	-
glossary	String	-	A fordításhoz használt terminológiai glosszárium neve	-
preview	Boolean	false	Csak előnézet generálása. Csak előnézet generálásakor 2 kredit befizetésével lehet létrehozni a dokumentumfordítás előnézetét	-
shouldTranslateImage	Boolean	false	Dokumentumban található képek fordításának engedélyezése Csak PDF / DOCX / PPTX / EPUB / ODS / ODT / ODF formátumok támogatottak	-
forceOCR	Boolean	false	OCR kényszerített használata a dokumentum tartalmának felismeréséhez. Bekapcsolás után a képfordítás is engedélyezve lesz.	-
shouldTranslateFileName	Boolean	true	Fájlnév fordítása	-
strictSourceLanguageCheck	Boolean	false	Csak a forrásnyelven felismert szövegek fordítása?Bekapcsolás után szigorúbban szűri a nem forrásnyelvű tartalmakat, és a költségszámításhoz is szigorúbb együtthatót használ.	-
outputFormat	String	-	Kimeneti formátum. MD megadásakor a rendszer megpróbál Markdown fordítást generálni.	MD
bilingualMode	String	Horizontal	Kétnyelvű fájl elrendezési iránya. A Horizontal vízszintes elrendezést jelent, a Vertical függőleges elrendezést jelent.	Horizontal
password	String	-	PDF fájl megnyitási jelszava	-
ignoreComments	Boolean	false	Figyelmen kívül hagyja-e a DOCX, PPTX és XLSX megjegyzéseket	-
ignoreNotes	Boolean	false	Figyelmen kívül hagyja-e a PPTX jegyzeteket	-
ignoreHeadersAndFooters	Boolean	false	Figyelmen kívül hagyja-e a DOCX lábléc és fejléc elemeket	-
ignoreHidden	Boolean	false	Figyelmen kívül hagyja-e a PPTX rejtett diákat	-
ignoreMasters	Boolean	false	Figyelmen kívül hagyja-e a PPTX minta szövegeket	-
ignoreSheetNames	Boolean	false	Ne fordítsa le az XLSX munkalapnevek	-
extractTextRegExpPattern	String	-	Csak a reguláris kifejezésnek megfelelő tartalom fordítása és annak lecserélése a fordítással Csak a txmsg formátum támogatott	-
extractTextRegExpFlags	String	-	Reguláris kifejezések jelzői: g, s, m, u, y Csak txmsg támogatott	-
allowFlip	Boolean	true	Engedélyezi-e az oldalelrendezés tükrözését jobbról balra írott nyelvek esetén. false érték átadásakor a képtükrözés is kikapcsol.	-
allowFlipImage	Boolean	true	Engedélyezi-e a képtartalom tükrözését jobbról balra írott nyelvek esetén.	-
webhookUrl	String	-	Callback URL állapotfrissítéskor, a visszahívás tartalma: {taskId, progress, status}	-

Válasz

Paraméterek	Típus	Alapértelmezett	Leírás	Példa
taskId	String	-	Feladatazonosító	-

Gyakori hibák

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.