一个基于 Next.js 构建的翻译 API 服务,底层调用有道翻译的 Web 翻译接口,按沉浸式翻译格式返回结果,可直接作为沉浸式翻译的自定义翻译服务使用。
- ⚡ 批量翻译:一次请求可携带多段文本(
text_list),逐段翻译并返回等长结果,与输入一一对应。 - 🌐 自动语言检测:
source_lang与target_lang均可省略或传auto,自动识别源语言、选择目标语言。 - 🧠 多模型支持:可选
llmLite(默认)与llmPro两种有道翻译模型,按需权衡速度与质量。 - 📖 术语模式:支持开启有道术语库(
use_term),提升专业术语翻译的准确性。 - 🔌 沉浸式翻译适配:内置沉浸式翻译语言代码与有道代码的自动映射,兼容
zh-CN、zh-TW、zh-Hans、zh-Hant等写法。 - 🚀 流式翻译:内部基于 SSE 流读取有道翻译结果,将增量内容拼接为完整译文后统一返回。
健康检查 GET /
{ "status": "ok", "service": "fanyi" }翻译 POST /translate
请求体(JSON):
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
text_list |
string[] |
是 | 待翻译的文本数组,非空 |
source_lang |
string |
否 | 源语言,默认 auto |
target_lang |
string |
否 | 目标语言,默认 auto |
model |
string |
否 | llmLite / llmPro,默认 llmLite |
cookie |
string |
否 | 有道登录态 Cookie;llmPro 必填 |
use_term |
boolean |
否 | 是否启用术语模式,默认 false |
成功响应:
{
"translations": [
{ "detected_source_lang": "en", "text": "你好" }
]
}| 场景 | 状态码 |
|---|---|
| 请求体非法 JSON | 400 |
text_list 缺失或格式错误 |
400 |
上游翻译失败(文本为空、超 5000 字符、模型不支持、llmPro 缺 Cookie 等) |
502 |
本 README 文档由 AI 辅助生成。如有问题,请提交 Issue 或与我联系!