翻译接口

接口说明

提供多语言之间的文本翻译能力，适合需要在应用或页面中快速接入翻译功能的开发者使用。接口免费开放，无需密钥即可调用。

调用地址

https://mini10.top/api/translate.php

请求方式

使用 GET 请求方式发起调用。

鉴权说明

本接口无需密钥，不需要在请求中携带任何鉴权凭证，可直接调用。

请求参数

调用地址：https://mini10.top/api/translate.php，请求方式：GET。本接口无需密钥，免费调用。

参数取值说明：

• from 与 to 均为语言缩写字符串，需使用对应的语言代码，例如 en（英语）、zh（中文）。
• 三个参数均通过查询参数传递，缺一不可；content 建议进行 URL 编码，以避免特殊字符导致解析异常。

成功响应示例

请求成功后，接口返回 application/json 格式数据，code 为 0、msg 为 ok，翻译结果位于 data 数组中。

{
  "code": 0,
  "msg": "ok",
  "data": [
    {
      "translations": [
        {
          "text": "你好",
          "to": "zh-Hans",
          "sentLen": {
            "srcSentLen": [2],
            "transSentLen": [2]
          }
        }
      ]
    }
  ]
}

响应字段说明

说明：data 与 translations 均为数组结构，多个输入片段会依次对应其中的元素；读取结果时请以 data[].translations[].text 作为译文取值路径。

错误响应示例

当请求未能正常完成时，接口统一返回如下结构的 JSON 数据：code 字段保持固定值 0，具体失败原因由 errcode 与 msg 共同给出。调用方应优先根据 errcode 判断错误类型，再展示或记录 msg 的内容。

未提供调用密钥：

{
  "code": 0,
  "msg": "未提供调用密钥",
  "errcode": 11001
}

请求方式不允许（本接口调用地址 https://mini10.top/api/translate.php 仅接受 GET 请求）：

{
  "code": 0,
  "msg": "请求方式不允许",
  "errcode": 11018
}

接口维护中：

{
  "code": 0,
  "msg": "接口维护中",
  "errcode": 11006
}

接口不存在（调用地址书写有误时）：

{
  "code": 0,
  "msg": "接口不存在",
  "errcode": 11013
}

业务错误码说明

下表列出本站接口所有业务错误码及其含义，便于统一处理异常。本接口为免费接口且无需密钥，实际调用中通常不会出现密钥与积分类的错误码，但为保持各接口错误处理逻辑一致，错误码体系整体一致，建议调用方按完整列表实现判断分支。

调用示例

终端 curl（bash）

curl -G "https://mini10.top/api/translate.php" \
  --data-urlencode "content=Hello" \
  --data-urlencode "from=en" \
  --data-urlencode "to=zh"

接口无需密钥，直接以 GET 方式携带 content、from、to 三个参数即可发起请求，返回 JSON 中的 data[0].translations[0].text 为翻译结果。

PHP

// PHP 调用示例
$url = "https://mini10.top/api/translate.php";
$params = [
    "content" => "Hello",
    "from"    => "en",
    "to"      => "zh",
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url . "?" . http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);

$response = curl_exec($ch);
if ($response === false) {
    echo "请求失败：" . curl_error($ch);
} else {
    $result = json_decode($response, true);
    if (isset($result["data"][0]["translations"][0]["text"])) {
        echo $result["data"][0]["translations"][0]["text"];
    } else {
        echo $response;
    }
}

curl_close($ch);

注意事项

• 无需密钥：本接口为公开调用，不需要传入任何密钥或身份凭据。请不要在请求中附带账号、密码、令牌等信息，也不要将私人凭据写入参数。
• 使用 HTTPS 并保持地址原样：请完整使用 https://mini10.top/api/translate.php，不要改为 http，也不要省略路径或自行拼接参数路径。
• GET 参数必须正确编码：content 会直接出现在 URL 中，中文、空格、换行以及 &、=、#、? 等字符必须进行 URL 编码，否则文本会被截断或解析出错。
• 不要在 content 中提交敏感信息：由于文本通过 URL 传递，可能被浏览器历史、访问日志等记录，请勿提交密码、证件号码等敏感内容。
• 三个参数均为必填：content、from、to 缺一不可。from 与 to 需使用有效的语言缩写（如 en、zh），取值拼写错误或使用未支持的语言代码时，返回结果可能不符合预期。
• 长文本建议分段提交：GET 请求的 URL 长度有限，过长的文本可能被截断，请拆分后多次调用。
• 控制调用频率：本接口免费开放，但请避免高频轮询、并发高频请求或用于大规模批量抓取，批量翻译时建议串行提交，并在每次调用之间保留间隔。
• 正确解析返回结构：code 为 0 且 msg 为 ok 表示调用成功，翻译结果位于 data[0].translations[0].text；请对 code 非 0 或 data 为空的情况做容错处理，不要直接假设结果一定存在。