Documentinhoudsopgave

Translation Task API

Vertaalde tekst

POST/v1/translation/translateTexts

Vertaal tekst en geef de vertaalresultaten synchroon terug.

Volledig adres
https://shangyiai.com/api/v1/translation/translateTexts
Authenticatie
De API Key moet doorgegeven worden in de Authorization-verzoekheader
Content-Type
application/json
Onjuist formaat
{ "error": "Invalid API key." }

Aandachtspunten

Deze interface slaat de ingevoerde tekst tijdelijk op als JSON-document en verwerkt deze synchroon, geschikt voor onmiddellijke vertaling van kleine hoeveelheden tekst.

Het creditsaldo van de account moet minimaal 2 credits bedragen. Als de werkelijke kosten het saldo overschrijden, retourneert de interface taskId en price, en geeft aan dat het saldo onvoldoende is.

Voorbeeld

curl
1curl -X POST 'https://shangyiai.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}'

Verzoekparameters

ParametersTypeStandaardBeschrijvingVoorbeeld
*textsString[]-

Te vertalen tekst

-
*fromLangString-
  • Brontaal, de brontaal mag niet hetzelfde zijn als de doeltaal
  • Ondersteunde talen: opvragen
-
*toLangString-
  • Doeltaal, de doeltaal kan niet hetzelfde zijn als de brontaal
  • Ondersteunde talen: opvragen
-
modelString-
  • AI-model voor vertaling
  • Ondersteunde modellen: opvragen
-
fileDescriptionString-

Documentbeschrijving: verbeter de vertaalkwaliteit door aanvullende informatie te verstrekken, zoals het toevoegen van extra documentachtergrond en andere vertaalvereisten

-

Reactie

ParametersTypeStandaardBeschrijvingVoorbeeld
taskIdString-

Taak-ID

-
translatedTextsString[]-

Vertaalde tekst

-
priceInteger-

Totaal aantal benodigde credits voor de vertaling

-
usedCreditsInteger-

Aantal Credits gebruikt door de vertaaltaak

-

Veelvoorkomende fouten

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.