Dokumentindhold

Oversættelsesopgave API

Oversæt tekst

POST/v1/translation/translateTexts

Oversæt tekst og returner oversættelsesresultater synkront.

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

Forholdsregler

Dette endpoint gemmer midlertidigt den indsendte tekst som et JSON-dokument og behandler den synkront, velegnet til øjeblikkelig oversættelse af små tekstmængder.

Kontosaldoen skal være mindst 2 credits. Hvis de faktiske omkostninger overstiger saldoen, returnerer API'en taskId og price og giver besked om utilstrækkelig saldo.

Eksempel

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}'

Forespørgselsparametre

ParametreTypeStandardBeskrivelseEksempel
*textsString[]-

Tekst der skal oversættes

-
*fromLangString-
  • Kildesprog, kildesproget kan ikke være identisk med målsproget
  • Understøttede sprog: forespørgsel
-
*toLangString-
  • Målsprog, målsproget kan ikke være identisk med kildesproget
  • Understøttede sprog: forespørgsel
-
modelString-
  • AI-model til oversættelse
  • Understøttede modeller: forespørgsel
-
fileDescriptionString-

Dokumentbeskrivelse: ved at tilføje yderligere information forbedres oversættelseskvaliteten, for eksempel ekstra dokumentbaggrundsinformation og andre oversættelseskrav

-

Svar

ParametreTypeStandardBeskrivelseEksempel
taskIdString-

Opgave-ID

-
translatedTextsString[]-

Den oversatte tekst

-
priceInteger-

Det samlede antal Credits der kræves til oversættelsen

-
usedCreditsInteger-

Antal Credits brugt af oversættelsesopgaven

-

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 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.

Oversættelsesopgave API
Genstart oversættelsesopgave