翻譯 API
使用最先進的 AI 將字幕翻譯成 100 多種語言,擴大您的影響力。
POST
/api/v1/translate快速實現
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
請求參數
| 參數 | 類型 | 是否必填 | 描述 |
|---|---|---|---|
projectId | String | Yes | 待翻譯項目的唯一識別碼。 |
targetLanguageCode | String | Yes | ISO 639-1 代碼 (例如 'es', 'fr', 'zh-CN')。 |
modelId | String | No | 'pro' (高品質, 1 額度/分鐘) 或 'basic' (快速, 1 額度/2 分鐘)。預設為 'basic'。 |
高級:基礎模型 (成本優化)
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
成功響應
成功的請求返回 200 OK 狀態。翻譯後的字幕將立即同步,並可供導出或在工作區中進一步修改。
{ "success": true, "projectId": "proj_8k2n9m1b", "targetLanguageCode": "es", "modelId": "pro" }
錯誤代碼
| 參數 | 類型 | 是否必填 | 描述 |
|---|---|---|---|
| 400 | missing_parameter | 缺失項目 ID 或目標語言。 | |
| 401 | unauthorized | API 金鑰缺失或無效。 | |
| 404 | not_found | 項目 ID 不存在。 | |
| 403 | insufficient_balance | 操作額度不足。 | |
| 500 | translation_failed | AI 引擎處理請求失敗。 | |
| 500 | server_error | 發生意外的內部伺服器錯誤。 |
錯誤響應結構
{ "success": false, "error": "not_found", "message": "找不到 ID 為 'proj_unknown' 的項目。" }
本頁面對您有幫助嗎?