API Traduzione
Espandi la tua portata traducendo i tuoi sottotitoli in oltre 100 lingue utilizzando un'AI all'avanguardia.
POST
/api/v1/translateImplementazione Rapida
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
Parametri della Richiesta
| Parametro | Tipo | Richiesto | Descrizione |
|---|---|---|---|
projectId | String | Yes | L'identificatore univoco del progetto da tradurre. |
targetLanguageCode | String | Yes | Codice ISO 639-1 (es. 'es', 'fr', 'zh-CN'). |
modelId | String | No | 'pro' (Alta Qualità, 1 credito/min) o 'basic' (Veloce, 1 credito/2 min). Il valore predefinito è 'basic'. |
Avanzato: Modello Base (Ottimizzato per i costi)
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
Risposta di Successo
Una richiesta riuscita restituisce uno stato 200 OK. I sottotitoli tradotti sono immediatamente sincronizzati e disponibili per l'esportazione o ulteriori modifiche nell'area di lavoro.
{ "success": true, "projectId": "proj_8k2n9m1b", "targetLanguageCode": "es", "modelId": "pro" }
Codici di Errore
| Parametro | Tipo | Richiesto | Descrizione |
|---|---|---|---|
| 400 | missing_parameter | Manca l'ID del progetto o la lingua di destinazione. | |
| 401 | unauthorized | Chiave API mancante o non valida. | |
| 404 | not_found | L'ID del progetto non esiste. | |
| 403 | insufficient_balance | Crediti insufficienti per l'operazione. | |
| 500 | translation_failed | Il motore AI non è riuscito a elaborare la richiesta. | |
| 500 | server_error | Si è verificato un errore interno del server imprevisto. |
Struttura della Risposta di Errore
{ "success": false, "error": "not_found", "message": "Non è stato possibile trovare il progetto con ID 'proj_unknown'." }
Questa pagina è stata utile?