NTab翻译API文档

NTab翻译API提供强大的多语言翻译服务，支持NTab翻译和NTab AI两种翻译引擎。

快速开始

要使用NTab翻译API，您需要向我们的API端点发送HTTP POST请求。

POST /api/translate.php

文本翻译API端点

请求参数

参数	类型	必填	描述
text	String	是	需要翻译的文本内容
from	String	否	源语言代码，默认为'auto'(自动检测)
to	String	否	目标语言代码，默认为'en'(英语)
engine	String	否	翻译引擎，可选'baidu'或'deepseek'，默认为'baidu'

示例请求

// 使用cURL的示例
curl -X POST \
  https://fanyi.ntab.ink/api/translate.php \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'text=你好世界&from=zh&to=en&engine=deepseek'
                

响应格式

API返回JSON格式的响应，包含以下字段：

字段	类型	描述
text	String	原始文本
from	String	源语言代码
to	String	目标语言代码
engine	String	使用的翻译引擎
translation	String	翻译结果

示例响应

{
    "text": "你好世界",
    "from": "zh",
    "to": "en",
    "engine": "deepseek",
    "translation": "Hello world"
}
                

支持的语言

NTab翻译API支持以下语言代码：

语言代码	语言名称
auto	自动检测
zh	中文简体
cht	中文繁体
en	英语
jp	日语
kor	韩语
fra	法语
de	德语
ru	俄语
spa	西班牙语
pt	葡萄牙语
it	意大利语
nl	荷兰语
pl	波兰语
ara	阿拉伯语
th	泰语
vie	越南语
id	印尼语

错误处理

当出现错误时，API会返回HTTP错误码和错误信息：

HTTP状态码	错误信息	解决方案
400	缺少必要参数: text	确保提供了text参数
400	不支持的语言代码	检查from和to参数是否使用支持的语言代码
400	不支持的翻译引擎	engine参数只能是'baidu'或'deepseek'
500	获取NTab访问令牌失败	联系管理员检查NTabAPI配置
500	DeepSeek翻译出错	检查DeepSeek API密钥是否有效

注意： 本API目前为公开测试版，可能会进行调整。如需生产环境使用，请联系我们获取稳定版本。

API使用示例

JavaScript示例

// 使用fetch API调用翻译服务
async function translateText(text, from, to, engine) {
    const formData = new FormData();
    formData.append('text', text);
    formData.append('from', from);
    formData.append('to', to);
    formData.append('engine', engine);
    
    try {
        const response = await fetch('https://fanyi.ntab.ink/api/translate.php', {
            method: 'POST',
            body: formData
        });
        
        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }
        
        const data = await response.json();
        return data.translation;
    } catch (error) {
        console.error('翻译出错:', error);
        return '翻译服务暂时不可用';
    }
}

// 使用示例
translateText('你好', 'zh', 'en', 'deepseek')
    .then(translation => console.log(translation));
                

Python示例

import requests

def translate_text(text, from_lang='auto', to_lang='en', engine='baidu'):
    url = "https://fanyi.ntab.ink/api/translate.php"
    data = {
        'text': text,
        'from': from_lang,
        'to': to_lang,
        'engine': engine
    }
    
    try:
        response = requests.post(url, data=data)
        response.raise_for_status()
        return response.json()['translation']
    except requests.exceptions.RequestException as e:
        print(f"翻译出错: {e}")
        return "翻译服务暂时不可用"

# 使用示例
translation = translate_text("こんにちは", "jp", "zh", "deepseek")
print(translation)
                

常见问题

Q: API有调用限制吗？

A: 目前测试阶段，每个IP每分钟限制60次调用。如需更高限制，请联系我们。

Q: 如何选择翻译引擎？

A: NTab翻译适合常规文本，NTab AI更适合复杂语境和专业术语翻译。

Q: 可以同时翻译多段文本吗？

A: 当前API设计为单次请求翻译单段文本，如需批量翻译，请多次调用API。

Q: 如何获取API密钥？

A: 目前为公开API，无需密钥。未来可能会引入认证系统。