SimplyTranslate AI - API文档

免费RESTful翻译API - 支持196+种语言

快速开始

几分钟内开始使用我们的免费翻译API。基本使用无需API密钥。

curl -X POST https://api.simplytranslate.ai/translate \
  -H "Content-Type: application/json" \
  -d '{
    "text": "你好,世界!",
    "from": "en",
    "to": "zh-cn"
  }'

响应: {"result": "$你好,世界!", "from": "en", "to": "zh-cn"}

基础URL

https://api.simplytranslate.ai

所有API请求都应发送到此基础URL。API使用HTTPS并支持CORS用于基于浏览器的应用程序。

身份验证

我们的API支持身份验证和匿名请求:

匿名使用(免费)

  • 无需API密钥
  • 每个IP每分钟100个请求
  • 每个请求最多5,000字符
  • 支持所有语言

使用API密钥(可选)

  • 更高的速率限制
  • 优先处理
  • 使用分析
  • 企业支持
X-API-Key: your-api-key

翻译端点

POST/translate

以高精度和速度将文本从一种语言翻译为另一种语言。

请求体

{
  "text": "要翻译的文本(必需)",
  "from": "源语言代码(必需)",
  "to": "目标语言代码(必需)",
  "token": "Turnstile令牌(可选)"
}

参数

参数类型必需描述
textstring要翻译的文本(最多5,000字符)
fromstring源语言代码(例如:"en"、"auto")
tostring目标语言代码(例如:"zh-cn"、"ja")
tokenstringCloudflare Turnstile验证令牌

响应格式

// 成功响应 (200 OK)
{
  "result": "翻译后的文本",
  "from": "检测/使用的源语言",
  "to": "使用的目标语言",
  "confidence": 0.98,
  "timestamp": "2024-12-19T10:30:00Z"
}
// 错误响应 (4xx/5xx)
{
  "error": "错误描述",
  "code": "ERROR_CODE",
  "details": "附加错误信息"
}

支持的语言代码

我们的API支持196+种语言。以下是最常用的语言代码:

主要语言

英语en
中文(简体)zh-cn
中文(繁体)zh-tw
日语ja
韩语ko
法语fr
德语de
西班牙语es

欧洲语言

意大利语it
葡萄牙语pt
俄语ru
波兰语pl
荷兰语nl
瑞典语sv
挪威语no
丹麦语da

其他语言

阿拉伯语ar
印地语hi
泰语th
越南语vi
印尼语id
土耳其语tr
希伯来语he
自动检测auto

注意: 有关所有196+种支持语言的完整列表,请访问我们的语言页面.

速率限制和配额

免费层限制

  • 速率限制: 每个IP每分钟100个请求
  • 文本限制: 每个请求最多5,000字符
  • 每日限制: 常规使用无每日限制
  • 并发请求: 最多10个同时

速率限制头

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1640995200

这些头包含在每个API响应中,帮助您跟踪使用情况。

超出速率限制(429)

如果超出速率限制,您将收到429状态码。等待重置时间或考虑升级到更高级别。

错误代码

状态码错误代码描述
400INVALID_REQUEST缺少或无效参数
401UNAUTHORIZED无效的API密钥
403FORBIDDEN安全验证失败
413TEXT_TOO_LONG文本超过5,000字符限制
429RATE_LIMIT_EXCEEDED请求过多
500INTERNAL_ERROR服务器错误,请重试

代码示例

JavaScript(Fetch)

const translateText = async (text, from, to) => {
  const response = await fetch('https://api.simplytranslate.ai/translate', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      text: text,
      from: from,
      to: to
    })
  });
  
  const result = await response.json();
  return result;
};

// 用法
translateText('你好,世界!', 'en', 'zh-cn')
  .then(result => console.log(result.result))
  .catch(error => console.error('错误:', error));

Python(requests)

import requests
import json

def translate_text(text, from_lang, to_lang):
    url = "https://api.simplytranslate.ai/translate"
    
    payload = {
        "text": text,
        "from": from_lang,
        "to": to_lang
    }
    
    response = requests.post(
        url,
        headers={"Content-Type": "application/json"},
        data=json.dumps(payload)
    )
    
    return response.json()

# 用法
result = translate_text("你好,世界!", "en", "zh-cn")
print(result["result"])  # 输出: 你好,世界!

cURL

# 基本翻译
curl -X POST https://api.simplytranslate.ai/translate \
  -H "Content-Type: application/json" \
  -d '{
    "text": "你好,世界!",
    "from": "en",
    "to": "zh-cn"
  }'

# 使用API密钥(可选)
curl -X POST https://api.simplytranslate.ai/translate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key-here" \
  -d '{
    "text": "你好,世界!",
    "from": "en",
    "to": "ja"
  }'

最佳实践

性能提示

  • 尽可能将多个短文本批处理到单个请求中
  • 对未知源语言使用自动检测("auto")
  • 为速率限制处理实现指数退避
  • 缓存重复内容的翻译
  • 对所有请求使用HTTPS

错误处理

  • 始终检查响应状态码
  • 实现带延迟的重试逻辑
  • 优雅地处理网络超时
  • 发送前验证输入文本长度
  • 记录错误以便调试