Übersetzungsaufgaben-API
Übersetzungsaufgabe neu starten
Für den Neustart beendeter Aufgaben oder zur Zahlung von Punkten für Volltextübersetzungen
- Vollständige Adresse
- https://otranslator.com/api/v1/translation/start
- Authentifizierung
- Der API Key muss im Authorization-Anfrage-Header übermittelt werden
- Content-Type
- application/json
- Falsches Format
- { "error": "Invalid API key." }
Hinweise
Diese Schnittstelle kann zum Neustart von Terminated-Aufgaben verwendet werden und ermöglicht nach Abschluss der Vorschau-Aufgabe die Zahlung über payWithCredits sowie den Start der Volltext-Übersetzung.
Bereits bezahlte Aufgaben werden nicht erneut in Rechnung gestellt. Bei der Übergabe von model wird dieser nur zur Neuberechnung der Gebühren verwendet, wenn payWithCredits true ist und die Aufgabe noch nicht bezahlt wurde.
Beispiel
1curl -X POST 'https://otranslator.com/api/v1/translation/start' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5 "taskId": "[string]"
6}'Anfrageparameter
| Parameter | Typ | Standard | Beschreibung | Beispiel |
|---|---|---|---|---|
| *taskId | String | - | Übersetzungsauftrags-ID | - |
| payWithCredits | Boolean | - | Übersetzungsauftrag kostenpflichtig ausführen – nur wirksam bei noch nicht bezahlten Dokumenten; bereits bezahlte Dokumente werden nicht doppelt berechnet | - |
| model | String | - |
| - |
Antwort
| Parameter | Typ | Standard | Beschreibung | Beispiel |
|---|---|---|---|---|
| success | Boolean | - | Ob der Start erfolgreich war | - |
Häufige Fehler
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.