参数名	类型	必填	说明	示例
key	string	是	接口调用密钥
msg	string	是	需要翻译的内容	我爱你

中英翻译

接口说明

该接口提供中文与英文互译服务，支持自动识别源语言并返回翻译结果。适用于需要快速转换双语文本内容的开发者及应用程序，调用免费且具备较高的频率限制。

调用地址

/api/content/translate.php

请求方式

支持 GET 和 POST 两种请求方法。

鉴权说明

调用该接口必须携带密钥。密钥通过查询参数（Query）传递，参数名为 key，例如：?key=YOUR_API_KEY。

请求参数

调用地址：/api/content/translate.php

该接口支持 GET 与 POST 请求方式，所有参数均通过 Query String 传递。调用时必须携带密钥，计费模式为免费，频率限制约为每分钟 120 次。

参数名	类型	必填	说明
`key`	string	是	接口调用密钥。必须通过 URL 查询参数（Query）的方式传递，例如 `?key=你的密钥`。
`msg`	string	是	需要翻译的文本内容。支持中英文自动识别与互译，示例值：`"我爱你"`。

参数取值说明：

key：该参数是唯一且必须的鉴权标识，缺失或错误将导致请求被拒绝。
msg：传入的文本将由系统自动识别源语言（source）和目标语言（target）。若未指定，默认执行自动检测（auto）至自动目标（auto）的翻译逻辑，通常适用于中英互译场景。

成功响应示例

{
  "code": 200,
  "msg": "获取成功",
  "data": {
    "sourceText": "演艺经历：文章上中学时...",
    "source": "auto",
    "target": "auto",
    "targetText": [
      "Acting experience: when the article was in middle school..."
    ],
    "raw": {
      "errCode": 0,
      "errMsg": "",
      "sourceText": "演艺经历：文章上中学时...",
      "targetText": "Acting experience: when the article was in middle school...",
      "source": "zh",
      "target": "en",
      "engine": "nmt_cpp",
      "traceId": "af50d96e4ceb45a28b4c81efe3a6badb",
      "sessionUuid": "733dfdd7-59bc-474d-8fd8-3afd0857f56a"
    }
  }
}

响应字段说明

字段	类型	说明
code	integer	响应状态码，`200` 表示请求成功。
msg	string	响应描述信息。
data	object	业务数据对象。
data.sourceText	string	输入的源语言文本内容。
data.source	string	源语言标识，`auto` 表示自动检测。
data.target	string	目标语言标识，`auto` 表示自动检测。
data.targetText	array[string]	翻译结果文本数组，通常包含一个元素的字符串。
data.raw	object	原始详细响应数据。
data.raw.errCode	integer	原始错误码，`0` 表示成功。
data.raw.errMsg	string	原始错误信息，成功时为空字符串。
data.raw.sourceText	string	原始源语言文本。
data.raw.targetText	string	原始目标语言文本。
data.raw.source	string	原始源语言代码（如 `zh`）。
data.raw.target	string	原始目标语言代码（如 `en`）。
data.raw.engine	string	翻译引擎标识。
data.raw.traceId	string	链路追踪 ID。
data.raw.sessionUuid	string	会话唯一标识。

错误响应示例

当调用失败时，接口返回以下统一格式的 JSON 响应体：

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

code：固定为 0，表示请求处理流程正常完成（非 HTTP 状态码）。
msg：具体错误描述信息。
errcode：业务错误码，用于程序化判断失败原因。

业务错误码说明

调用中英翻译接口可能返回以下业务错误码。请根据 errcode 字段值进行异常处理与排查。

错误码	含义	说明
11001	未提供调用密钥	请求中缺少 `key` 参数。
11002	密钥错误	提供的 `key` 值无效或不存在。
11003	密钥已禁用	该密钥状态为禁用，无法调用接口。
11004	积分余额不足	账户积分耗尽，无法执行付费操作。
11005	请求过于频繁（QPM 限制）	触发每分钟 120 次频率限制，需稍后重试。
11006	接口维护中	接口正在进行系统维护，暂时不可用。
11007	接口已禁用	该接口功能已被平台管理员禁用。
11008	接口不可用	接口服务异常或配置错误，无法响应。
11009	密钥校验暂不可用	密钥验证服务暂时故障，请重试。
11010	积分系统暂不可用	积分计费服务暂时故障，请重试。
11011	收费接口须提供有效密钥	该接口为收费接口，必须提供有效且余额充足的密钥。
11012	鉴权方式错误	请求使用了不支持的鉴权方式，请确保使用 Query 参数 `key`。
11013	接口不存在	请求的接口路径 `/api/content/translate.php` 在当前服务中未注册或已移除。
11014	***地址无效	内部配置的后端服务地址格式错误。
11015	***地址不允许	内部配置的后端服务地址不在允许列表中。
11016	***请求失败	调用后端翻译引擎失败，请检查网络或稍后重试。
11017	服务暂不可用	整个翻译服务集群暂时过载或不可用。
11018	请求方式不允许	使用了非 GET 或 POST 的 HTTP 方法。
11019	当前IP不在白名单内	调用方 IP 地址未加入接口白名单。
11020	启用出口代理须提供有效密钥	使用出口代理功能时必须提供有效密钥。
11021	未配置可用出口代理	请求使用代理功能，但当前环境未配置可用代理。
11022	出口代理不可用	配置的出口代理服务无法连接或响应超时。
11023	密钥已过期	密钥有效期已过，需申请新密钥。
11024	令牌分配积分不足	当前令牌被分配的积分额度已用尽。

调用示例

终端 curl（bash）

curl -X GET "https://your-domain.com/api/content/translate.php?key=YOUR_KEY&msg=我爱你"

PHP

// PHP

注意事项

密钥安全管理：接口调用必须携带密钥 key。请通过服务端环境变量或安全配置中心存储密钥，严禁将密钥硬编码在前端代码（如 JavaScript、HTML）中，以免因用户直接访问源码或抓包导致密钥泄露。
传输协议强制 HTTPS：请始终通过 HTTPS 协议调用接口 /api/content/translate.php。由于密钥通过 Query 参数（?key=...）传递，若使用 HTTP 明文传输，密钥及请求内容将在网络链路中暴露，存在被截获的风险。
频率限制与重试策略：接口频率限制约为每分钟 120 次。在批量翻译场景下，请控制并发数量或添加请求间隔（如每 500ms 一次请求），避免触发限流导致请求失败。若遇到限流响应，建议采用指数退避策略进行重试，而非立即高频重发。
内容长度与字符限制：msg 参数支持包含换行符（\r\n）、引用标记（如 [1]）等复杂文本，但建议单次请求内容不超过 5000 字符，以确保翻译质量与响应速度。对于超长文本，建议分段翻译后拼接。
自动语言检测机制：接口默认使用自动检测（auto）模式识别源语言和目标语言。如需指定特定语言对（如中文转英文），请确认***服务支持该配置；若无需指定，直接传入自然文本即可，系统将自动识别方向。
特殊字符处理：传入的 msg 内容若包含特殊 HTML 字符（如 `,&`）或正则符号，请在请求前进行适当的 URL 编码（GET 请求）或 JSON 字符串转义（POST 请求），避免解析错误。
响应数据解析：成功响应中，翻译结果位于 data.targetText 数组中。由于引擎可能返回多段翻译结果（对应原文结构），业务代码应遍历该数组并拼接展示，而非直接取第一个元素，以防丢失内容。
错误处理：若响应中 code 非 200，请检查 msg 字段获取具体错误信息（如“密钥无效”、“频率超限”、“参数缺失”等），并据此调整调用逻辑，避免盲目重试。

免责声明

欢迎使用 万象数据API（以下简称“本平台”，域名为 api.vsaa.cn）。在使用本平台提供的任何接口、数据及相关服务之前，请您务必仔细阅读并充分理解本免责声明的全部内容。您对本平台任何服务的使用，均视为您已阅读、理解并同意本声明的全部条款。

1. 本平台仅提供**技术接口与数据聚合服务**，不存储、不生产、不拥有任何原始数据内容。 2. 本平台所返回的数据均来源于公开网络或第三方接口，仅作**技术学习、研究与交流**之用。 3. 本平台不保证任何接口的**持续可用性、准确性、完整性或及时性**，接口可能因第三方原因随时变更、中断或停止。 1. 使用者应遵守中华人民共和国相关法律法规，以及其所在地的所有适用法律。 2. **禁止**将本平台接口用于任何违法违规用途，包括但不限于： - 侵犯他人知识产权、隐私权或其他合法权益； - 从事网络攻击、数据爬取滥用、恶意刷量等行为； - 传播违法、有害、虚假或不良信息； - 用于任何商业转售、二次分发而未获授权的情形。 3. 使用者应自行承担因使用本平台服务而产生的一切后果与法律责任。 1. 本平台**不收集、不存储**使用者的个人敏感信息。 2. 使用者通过接口提交的查询参数，仅用于当次请求处理，不做持久化留存。 3. 若接口涉及第三方数据，其版权与解释权归原数据方所有，本平台不承担相关争议责任。 1. 本平台以**“现状”**和**“现有”**为基础提供服务，不对服务作出任何明示或暗示的担保。 2. 因使用或无法使用本平台服务而导致的任何**直接、间接、偶然或必然损失**，本平台及其运营者均不承担任何责任。 3. 因不可抗力、网络故障、第三方服务中断、政策调整等原因导致的服务异常，本平台不承担责任。 1. 本平台的接口设计、文档、代码及相关标识，其知识产权归本平台所有。 2. 未经书面许可，任何单位或个人不得复制、修改、传播或用于商业用途。 1. 本平台有权随时修改本免责声明，修改后的内容将在本页面公布，不再另行通知。 2. 使用者应定期查阅本声明，继续使用即视为接受变更后的条款。 1. 本声明的最终解释权归 **万象数据API** 所有。 2. 如您不同意本声明的任何内容，请立即停止使用本平台服务。 3. 如因本声明产生争议，双方应友好协商解决；协商不成的，可提交本平台运营者所在地有管辖权的人民法院裁决。

最后更新日期：2026年10月6日

中英翻译

接口信息

请求参数

返回示例

详细文档

中英翻译

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

响应字段说明

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

免责声明

免责声明

推荐接口

二维码