🌍 多语言翻译 API
1 IC每400字符
快速准确地在 28 种语言之间进行翻译,针对长文本和高性能进行了优化。支持单次翻译和批量翻译。
试用演示
🚀 特点
-
28 种语言:
ar,bn,cs,de,en,es,fa,fr,he,hi,id,it,ja,km,ko,lo,ms,my,nl,pl,pt,ru,th,tl,tr,ur,vi,zh -
单次和批量端点
-
无限文本支持 – 自动按句子级别分块
-
高精度 – 使用 BERTScore 在真实数据集上进行评估
📈 性能基准 (泰语 → 英语)
在 SCB MT En-TH 2020 数据集的 133,330 个句子对上进行测试。
| 模式 | 每 100 句平均时间 |
|---|---|
| 🧠 批量 | 18.06 秒 |
| 🐌 单次 | 30.54 秒 |
💡 提示: 为了获得最佳性能,请使用批量 API。
🧪 质量 (BERTScore)
预测与参考之间的语义相似度得分(1.0 = 完全匹配)
| 源 → 目标 | BERTScore 平均值 |
|---|---|
| EN → MY | 0.9561 |
| EN → TH | 0.9506 |
| EN → JA | 0.9169 |
| JA → EN | 0.9146 |
| TH → EN | 0.8728 |
| TH → MY | 0.8571 |
| ZH → EN | 0.8571 |
✅ 所有测试对的得分均**> 0.80**
API 端点
🔹 单次翻译
POST /v1/text/translate
Content-Type: application/x-www-form-urlencoded
参数:
text: 要翻译的文本source_lang: 源语言代码 (例如en)target_lang: 目标语言代码 (例如th)max_length: (可选) 最大输出 token 数
示例:
curl -X POST "https://api.iapp.co.th/v1/text/translate" \
-H "apikey: YOUR_API_KEY" \
-F "text=Hello" \
-F "source_lang=en" \
-F "target_lang=th"
响应:
{
"translation": "สวัสดี",
"processing_time": 0.056
}
🔹 批量翻译
POST /v1/text/batch_translate
Content-Type: application/json
正文:
[
{
"text": "Hello",
"source_lang": "en",
"target_lang": "fr"
},
{
"text": "こんにちは",
"source_lang": "ja",
"target_lang": "en"
}
]
响应:
{
"results": [
{ "translation": "Bonjour", "index": 0 },
{ "translation": "Hello", "index": 1 }
]
}
🐍 Python 代码示例
import requests
def translate_text(text, source_lang, target_lang, api_key, api_url="https://api.iapp.co.th"):
"""
使用翻译 API 翻译文本
Args:
text (str): 要翻译的文本
source_lang (str): 源语言代码 (例如 'en', 'th', 'zh')
target_lang (str): 目标语言代码 (例如 'en', 'th', 'zh')
api_key (str): 您的 API 密钥
api_url (str): API 的基本 URL
Returns:
dict: 翻译响应
"""
data = {
"text": text,
"source_lang": source_lang,
"target_lang": target_lang
}
headers = {
"apikey": api_key
}
response = requests.post(f"{api_url}/v1/text/translate", data=data, headers=headers)
response.raise_for_status() # 对于 HTTP 错误引发异常
return response.json()
# 用法示例:
# result = translate_text("Hello", "en", "th", api_key="YOUR_API_KEY")
# print(result["translation"])
✅ 此代码使用 application/x-www-form-urlencoded 格式,符合 API 规范。
⚠️ 错误
| 代码 | 描述 |
|---|---|
| 400 | 请求无效 |
| 401 | API 密钥丢失或无效 |
| 429 |