Skip to content

Navigation Menu

Sign in
Sign up

Repository files navigation

fanyi-next

一个基于 Next.js 构建的翻译 API 服务,底层调用有道翻译的 Web 翻译接口,按沉浸式翻译格式返回结果,可直接作为沉浸式翻译的自定义翻译服务使用。

✨ 核心特性

  • 批量翻译:一次请求可携带多段文本(text_list),逐段翻译并返回等长结果,与输入一一对应。
  • 🌐 自动语言检测:source_langtarget_lang 均可省略或传 auto,自动识别源语言、选择目标语言。
  • 🧠 多模型支持:可选 llmLite(默认)与 llmPro 两种有道翻译模型,按需权衡速度与质量。
  • 📖 术语模式:支持开启有道术语库(use_term),提升专业术语翻译的准确性。
  • 🔌 沉浸式翻译适配:内置沉浸式翻译语言代码与有道代码的自动映射,兼容 zh-CNzh-TWzh-Hanszh-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 或与我联系!

About

网易有道翻译 沉浸式翻译适配

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Contributors

Languages

AltStyle によって変換されたページ (->オリジナル) /