Dokumentinnhold

Oversettelsesoppgave-API

Oversett tekst

POST/v1/translation/translateTexts

Oversett tekst og returner oversettelsesresultatet synkront.

Fullstendig adresse
https://dltranslator.com/api/v1/translation/translateTexts
Autentisering
API-nøkkelen må angis i Authorization-forespørselhodet
Content-Type
application/json
Feil format
{ "error": "Invalid API key." }

Forsiktighetsregler

Dette grensesnittet lagrer den innsendte teksten midlertidig som et JSON-dokument og behandler den synkront, egnet for øyeblikkelig oversettelse av små tekstmengder.

Kontopoengsaldoen må være minst 2 credits. Hvis faktisk kostnad overstiger saldoen, vil grensesnittet returnere taskId og price, og varsle om utilstrekkelig saldo.

Eksempel

curl
1curl -X POST 'https://dltranslator.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ørselsparametere

ParametereTypeStandardBeskrivelseEksempel
*textsString[]-

Tekst som skal oversettes

-
*fromLangString-
  • Kildespråk, kildespråket kan ikke være det samme som målspråket
  • Støttede språk: forespørsel
-
*toLangString-
  • Målspråk, målspråket kan ikke være det samme som kildespråket
  • Støttede språk: forespørsel
-
modelString-
  • AI-modell for oversettelse
  • Støttede modeller: forespørsel
-
fileDescriptionString-

Dokumentbeskrivelse - ved å gi ytterligere informasjon forbedres oversettelseskvaliteten, for eksempel ved å legge til ekstra dokumentbakgrunnsinformasjon og andre oversettelseskrav

-

Svar

ParametereTypeStandardBeskrivelseEksempel
taskIdString-

Oppgave-ID

-
translatedTextsString[]-

Den oversatte teksten

-
priceInteger-

Totalt antall Credits som kreves for oversettelsen

-
usedCreditsInteger-

Antall Credits brukt av oversettelsesoppgaven

-

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

Oversettelsesoppgave-API
Start oversettelsesoppgave på nytt