Translation API
Erweitern Sie Ihre Reichweite, indem Sie Ihre Untertitel mit modernster KI in über 100 Sprachen übersetzen.
POST
/api/v1/translateSchnelle Implementierung
curl -X POST https://api.srtgen.com/api/v1/translate \ -H "x-api-key: <YOUR_API_KEY>" \ -F "projectId=proj_8k2n9m1b" \ -F "targetLanguageCode=es" \ -F "modelId=pro"
POSThttps://api.srtgen.com/api/v1/translate
Anfrageparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
projectId | String | Yes | Die eindeutige ID des zu übersetzenden Projekts. |
targetLanguageCode | String | Yes | ISO 639-1 Code (z. B. 'es', 'fr', 'zh-CN'). |
modelId | String | No | 'pro' (hohe Qualität, 1 Credit/Min.) oder 'basic' (schnell, 1 Credit/2 Min.). Standard ist 'basic'. |
Fortgeschritten: Basis-Modell (kostenoptimiert)
curl -X POST https://api.srtgen.com/api/v1/translate \ -H "x-api-key: <YOUR_API_KEY>" \ -F "projectId=proj_8k2n9m1b" \ -F "targetLanguageCode=zh-CN" \ -F "modelId=basic"
POSThttps://api.srtgen.com/api/v1/translate
Erfolgsantwort
Eine erfolgreiche Anfrage gibt den Status 200 OK zurück. Die übersetzten Untertitel sind sofort synchronisiert und für den Export oder weitere Bearbeitungen im Arbeitsbereich verfügbar.
{ "success": true, "projectId": "proj_8k2n9m1b", "targetLanguageCode": "es", "modelId": "pro" }
Fehlercodes
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| 400 | missing_parameter | Projekt-ID oder Zielsprache fehlt. | |
| 401 | unauthorized | API-Key fehlt oder ist ungültig. | |
| 404 | not_found | Projekt-ID existiert nicht. | |
| 403 | insufficient_balance | Unzureichende Credits für den Vorgang. | |
| 500 | translation_failed | Die KI-Engine konnte die Anfrage nicht verarbeiten. | |
| 500 | server_error | Unerwarteter interner Serverfehler aufgetreten. |
Fehler-Antwortstruktur
{ "success": false, "error": "not_found", "message": "Das Projekt mit der ID 'proj_unknown' konnte nicht gefunden werden." }
War diese Seite hilfreich?