Translation Task API
Vertaalde tekst
Vertaal tekst en geef de vertaalresultaten synchroon terug.
- Volledig adres
- https://dltranslator.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
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}'Verzoekparameters
| Parameters | Type | Standaard | Beschrijving | Voorbeeld |
|---|---|---|---|---|
| *texts | String[] | - | Te vertalen tekst | - |
| *fromLang | String | - |
| - |
| *toLang | String | - |
| - |
| model | String | - |
| - |
| fileDescription | String | - | Documentbeschrijving: verbeter de vertaalkwaliteit door aanvullende informatie te verstrekken, zoals het toevoegen van extra documentachtergrond en andere vertaalvereisten | - |
Reactie
| Parameters | Type | Standaard | Beschrijving | Voorbeeld |
|---|---|---|---|---|
| taskId | String | - | Taak-ID | - |
| translatedTexts | String[] | - | Vertaalde tekst | - |
| price | Integer | - | Totaal aantal benodigde credits voor de vertaling | - |
| usedCredits | Integer | - | 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.