🌐 AI智能翻译

支持多语言之间的高质量翻译服务。支持自动语言检测、多种翻译模式和专业领域翻译。

请求URL	POST /api/translate 或 GET /api/translate
请求方法	POST / GET
认证方式	API Key（请求头：X-API-Key）

• 多语言支持：支持包括中文、英文、日文、韩文、法文、德文等20+种语言
• 三种翻译模式：通用翻译、学术翻译、技术文档翻译
• 专业领域翻译：支持法律、医学、工程、金融等专业领域
• 术语库支持：可自定义术语库以保证专业术语一致性

参数名	必填	类型	说明
text	是	string	待翻译的文本内容
source_lang	否	string	源语言代码，默认为 auto（自动检测）。支持的语言代码见下方表格
target_lang	否	string	目标语言代码，默认为 zh（中文）。支持的语言代码见下方表格
translate_mode	否	string	翻译模式，可选值：fast（快速）、standard（标准，默认）、accurate（精准）。默认为 standard
domain	否	string	专业领域，如 general（通用）、academic（学术）、technical（技术）、law（法律）、medical（医学）、engineering（工程）、finance（金融）等。默认为空字符串
preserve_format	否	boolean/string	是否保持原文格式，默认为 false。GET请求时传字符串 "true" 或 "false"

支持的语言代码

语言	代码
中文	zh
英文	en
日文	ja
韩文	ko
法文	fr
德文	de
西班牙文	es
俄文	ru

翻译模式说明

模式	适用场景	特点
fast（快速）	日常交流、快速翻译	速度优先，适合大批量翻译
standard（标准）	通用文档、平衡质量与速度	平衡质量与速度，默认模式
accurate（精准）	重要文档、学术论文、技术文档	质量优先，更准确严谨

专业领域说明

领域	代码	特点
通用(general)	general	适用于日常交流和通用文档
学术(academic)	academic	适用于学术论文和研究报告
法律(law)	law	专业法律术语，严谨准确
医学(medical)	medical	医学专业术语，权威可靠
工程(engineering)	engineering	工程技术术语，精确规范
金融(finance)	finance	金融专业术语，符合行业标准

请求示例

POST 请求（JSON）：

{
  "text": "人工智能是计算机科学的一个分支，它企图了解智能的实质，并生产出一种新的能以人类智能相似的方式做出反应的智能机器。",
  "source_lang": "auto",
  "target_lang": "en",
  "translate_mode": "standard",
  "domain": "academic",
  "preserve_format": false
}

POST 请求（自动检测语言）：

{
  "text": "Hello, world! This is a test of AI translation.",
  "source_lang": "auto",
  "target_lang": "zh"
}

GET 请求：

GET /api/translate?text=人工智能是计算机科学的一个分支...&source_lang=auto&target_lang=en&translate_mode=standard&domain=academic&preserve_format=false

参数名	类型	说明
code	integer	状态码，1 表示成功，0 表示失败
original_text	string	原文（成功时返回）
translated_text	string	译文（成功时返回）
source_lang	string	源语言代码（成功时返回）
target_lang	string	目标语言代码（成功时返回）
detected_target_lang	string	检测到的目标语言（成功时返回，如 zh、en、unknown）
translate_mode	string	使用的翻译模式（成功时返回）
domain	string	专业领域（成功时返回，如未指定则为 general）
preserve_format	boolean	是否保持原文格式（成功时返回）
text_length	integer	原文长度（成功时返回）
model	string	使用的AI模型名称（成功时返回）
using_backup	boolean	是否使用了备用模型（可选，成功时可能返回）
msg	string	错误信息（失败时返回）

响应示例

成功响应：

{
  "code": 1,
  "original_text": "人工智能是计算机科学的一个分支，它企图了解智能的实质，并生产出一种新的能以人类智能相似的方式做出反应的智能机器。",
  "translated_text": "Artificial intelligence is a branch of computer science that attempts to understand the essence of intelligence and produce a new kind of intelligent machine that can respond in a way similar to human intelligence.",
  "source_lang": "auto",
  "target_lang": "en",
  "detected_target_lang": "en",
  "translate_mode": "standard",
  "domain": "academic",
  "preserve_format": false,
  "text_length": 45,
  "model": "deepseek-chat"
}

成功响应（使用备用模型）：

{
  "code": 1,
  "original_text": "Hello, world!",
  "translated_text": "你好，世界！",
  "source_lang": "auto",
  "target_lang": "zh",
  "detected_target_lang": "zh",
  "translate_mode": "fast",
  "domain": "general",
  "preserve_format": false,
  "text_length": 13,
  "model": "maas",
  "using_backup": true
}

失败响应：

{
  "code": 0,
  "msg": "请提供要翻译的文本内容"
}

错误码	说明
400	请求参数错误（如缺少必填参数 text）
401	未提供API密钥或密钥无效
429	请求过于频繁，触发限流
500	服务器内部错误（AI模型调用失败等）