跳到主要内容

开发者文档

你的第一个翻译请求，从这里开始。

从获取密钥到处理结果，按步骤将翻译接入现有产品。

快速开始

使用服务端 API Key，通过 HTTPS 发送 JSON 请求。

  1. 01

    获取密钥

    在控制台创建 API Key。

  2. 02

    提交文本

    设置 text 与 target_lang。

  3. 03

    检查结果

    读取译文，记录请求信息。

cURL
curl -X POST https://api.deeplvip.com/api/v1/translate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello, world!","target_lang":"zh-Hans"}'

将 YOUR_API_KEY 替换为自己的密钥。请勿把密钥放进浏览器代码或公开仓库。

API 端点

翻译接口与运行状态各司其职，保持接入清晰。

POST/api/v1/translate

提交单段文本，获取译文、实际引擎与请求耗时。

GET/api/v1/engines

查看已注册的翻译引擎与当前可用状态。

GET/health

服务健康检查，用于部署环境与负载均衡。

GET/metrics

Prometheus 指标，用于观察用量、延迟与服务状态。

语言代码与响应信息

使用实际引擎支持的语言代码，例如 zh-Hans、en-US、ja 和 de。可选的 engine 参数用于指定引擎；不传时使用默认主引擎。

translation
译文内容
engine
实际使用的翻译引擎
characters
源文本字符用量
timing
请求耗时信息

让错误处理成为接入的一部分

4xx

先检查密钥、请求字段与语言代码，修正后再提交。

429

降低并发并进行带上限的指数退避；如有 Retry-After，应遵循等待时间。

503

按场景稍后重试或降级，避免无限重试。

记录 request_id、状态和耗时，避免在日志中保存凭证。引擎覆盖与当前接入状态请查看常见问题。

查看常见问题