翻译 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' 的项目。" }
本页面对您有帮助吗?