Dokumentkatalog

Översättningsuppgift-API

Översätt text

POST/v1/translation/translateTexts

Översätt text och returnera översättningsresultatet synkront.

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

Att observera

Detta gränssnitt sparar tillfälligt inmatad text som ett JSON-dokument och bearbetar det synkront, lämpligt för omedelbar översättning av små textmängder.

Kontots kreditsaldo måste vara minst 2 credits. Om den faktiska kostnaden överstiger saldot returnerar gränssnittet taskId och price och meddelar att saldot är otillräckligt.

Exempel

curl
1curl -X POST 'https://otranslator.com/api/v1/translation/translateTexts' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5  "texts": [
6    "string"
7  ],
8  "fromLang": "[string]",
9  "toLang": "[string]"
10}'

Förfrågningsparametrar

ParametrarTypStandardBeskrivningExempel
*textsString[]-

Text som behöver översättas

-
*fromLangString-
  • Källspråk, källspråket kan inte vara samma som målspråket
  • Språk som stöds: fråga
-
*toLangString-
  • Målspråk, målspråket får inte vara samma som källspråket
  • Språk som stöds: förfrågan
-
modelString-
  • AI-modell för översättning
  • Modeller som stöds: förfrågan
-
fileDescriptionString-

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.

-

Svar

ParametrarTypStandardBeskrivningExempel
taskIdString-

Uppgifts-ID

-
translatedTextsString[]-

Den översatta texten

-
priceInteger-

Totalt antal Credits som krävs för översättningen

-
usedCreditsInteger-

Antal Credits som använts för översättningsuppgiften

-

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 translate the texts.

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 Missing required parameter: texts.

Provide a non-empty texts array.

400 Failed to translate texts.

The text translation task could not be processed.

Översättningsuppgift-API
Starta om översättningsuppgift