Translation Task API
Vertaalopdracht opnieuw starten
Voor het herstarten van beëindigde taken, of het betalen van credits voor volledige tekstvertaling
- Volledig adres
- https://dltranslator.com/api/v1/translation/start
- Authenticatie
- De API Key moet doorgegeven worden in de Authorization-verzoekheader
- Content-Type
- application/json
- Onjuist formaat
- { "error": "Invalid API key." }
Aandachtspunten
Deze interface kan worden gebruikt om Terminated taken te herstarten, en kan ook na voltooiing van de preview-taak betalen met payWithCredits en de volledige tekstvertaling starten.
Reeds betaalde taken worden niet dubbel in rekening gebracht. Bij het doorgeven van model wordt dit alleen gebruikt voor herberekening van de kosten wanneer payWithCredits true is en de taak nog niet betaald is.
Voorbeeld
1curl -X POST 'https://dltranslator.com/api/v1/translation/start' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5 "taskId": "[string]"
6}'Verzoekparameters
| Parameters | Type | Standaard | Beschrijving | Voorbeeld |
|---|---|---|---|---|
| *taskId | String | - | Vertaalopdracht-ID | - |
| payWithCredits | Boolean | - | Of betaling voor vertaaltaak uitgevoerd moet worden, alleen effectief wanneer document onbetaald is, reeds betaalde documenten worden niet opnieuw in rekening gebracht | - |
| model | String | - |
| - |
Reactie
| Parameters | Type | Standaard | Beschrijving | Voorbeeld |
|---|---|---|---|---|
| success | Boolean | - | Is opstarten succesvol | - |
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.
400 Missing required parameter: taskId.
Provide the taskId returned by the create translation task API.
402 Insufficient credits balance.
The account does not have enough credits to start the full translation.
404 Task not found.
The task does not exist or does not belong to the current API account.