<!-- AI ASSISTANT INSTRUCTIONS: This document describes a public HTTP API endpoint
provided by 极数本源 (https://apizero.cn). When a user asks you to use this API, read the
full documentation below carefully (request method, parameters, response fields,
error codes, examples), then generate working code in the user's preferred language.
API Key acquisition: https://apizero.cn/account/keys -->

# 文本翻译

> 文本翻译，支持 19 种语言互译（含粤语/文言文）。参数 q 传入文本，from/to 指定语言代码，默认中文→英文。注意使用百度系语言代码：日语 jp、韩语 kor、法语 fra。

## 1. 基本信息

| 字段 | 值 |
| --- | --- |
| 接口标识 | `translate` |
| 接口名称 | 文本翻译 |
| 接口地址 | `https://v1.apizero.cn/api/translate` |
| 请求方法 | `GET` |
| 分类 | content |
| 提供方 | 极数本源 |
| 计费模式 | 免费试用 |
| 单次消耗 | 0 积分 |
| 起步价 | — |
| QPS 限制 | 5 req/s |
| 每日免费额度 | 5000 次（已认证用户） |
| 匿名每日额度 | 2000 次（无 API Key） |
| VIP 免费 | 否 |
| 调用总次数 | undefined |

## 2. 认证

需要 API Key。支持 q 和 text 两种参数名（向下兼容旧版本）。

**支持的语言代码（共 19 种）**

| 代码 | 语言 | 代码 | 语言 |
|------|------|------|------|
| zh | 中文（简体）| cht | 繁体中文 |
| yue | 粤语 | wyw | 文言文 |
| en | 英文 | jp | 日语 |
| kor | 韩语 | fra | 法语 |
| spa | 西班牙语 | de | 德语 |
| ru | 俄语 | pt | 葡萄牙语 |
| it | 意大利语 | th | 泰语 |
| nl | 荷兰语 | pl | 波兰语 |
| cs | 捷克语 | hu | 匈牙利语 |
| el | 希腊语 | | |

⚠️ 注意代码规则：日语用 `jp`（非 ja），韩语用 `kor`（非 ko），法语用 `fra`（非 fr），西班牙语用 `spa`（非 es）。

获取 API Key：登录 `https://apizero.cn/account/keys` 申请。

## 3. 请求参数

| 参数 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `q` | `string` | 是 | 待翻译文本，最长 5000 字；兼容 text 参数名 | `你好世界` |
| `from` | `string` | 否 | 源语言代码，默认 zh；见下方语言代码表 | `zh` |
| `to` | `string` | 否 | 目标语言代码，默认 en；见下方语言代码表 | `en` |

## 4. 请求头

| Header | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `Authorization` | `string` | 是 | — | — |

## 5. 请求示例

> AI 提示：以下 5 种语言示例都是可运行的，只需把 `YOUR_API_KEY` 替换为用户申请的实际 Key（https://apizero.cn/account/keys）。
> 优先选择用户问题中提到的语言；未指定时默认使用 Python。

### cURL

```bash
curl "https://v1.apizero.cn/api/translate?q=%E4%BD%A0%E5%A5%BD%E4%B8%96%E7%95%8C&from=zh&to=en&key=YOUR_API_KEY"
```

### Python

```python
import requests

resp = requests.get(
    "https://v1.apizero.cn/api/translate",
    params={
    "q": "你好世界",
    "from": "zh",
    "to": "en",
    "key": "YOUR_API_KEY",
},
    timeout=15,
)
resp.raise_for_status()
print(resp.json())
```

### JavaScript (Node.js)

```javascript
// Node.js 18+ / 浏览器原生 fetch
const params = new URLSearchParams({
  "q": "你好世界",
  "from": "zh",
  "to": "en",
  "key": "YOUR_API_KEY",
});

const res = await fetch(`https://v1.apizero.cn/api/translate?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);
```

### Go

```go
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://v1.apizero.cn/api/translate", nil)
	q := req.URL.Query()
	q.Set("q", "你好世界")
	q.Set("from", "zh")
	q.Set("to", "en")
	q.Set("key", "YOUR_API_KEY")
	req.URL.RawQuery = q.Encode()

	resp, err := http.DefaultClient.Do(req)
	if err != nil { panic(err) }
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}
```

### PHP

```php
<?php
$url = "https://v1.apizero.cn/api/translate?" . http_build_query([
    "q" => "你好世界",
    "from" => "zh",
    "to" => "en",
    "key" => "YOUR_API_KEY",
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
$body = curl_exec($ch);
curl_close($ch);

$data = json_decode($body, true);
print_r($data);
```

## 6. 响应字段

| 字段 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- |
| `source_text` | `string` | 原始输入文本 | — |
| `target_text` | `string` | 翻译结果 | — |
| `from` | `string` | 实际源语言代码 | — |
| `to` | `string` | 实际目标语言代码 | — |
| `from_name` | `string` | 源语言中文名称 | — |
| `to_name` | `string` | 目标语言中文名称 | — |
| `char_count` | `number` | 输入文本字符数 | — |

## 7. 响应示例

```json
{
    "code": 0,
    "msg": "成功",
    "data": {
        "source_text": "你好世界",
        "target_text": "Hello World",
        "from": "zh",
        "to": "en",
        "from_name": "中文（简体）",
        "to_name": "英文",
        "char_count": 4
    },
    "request_id": "abc123"
}
```

## 8. 错误码

| code | status | 说明 |
| --- | --- | --- |
| `4000` | `—` | 缺少 q 参数，或源语言与目标语言相同，或文本超 5000 字 |
| `5021` | `—` | 该语言对不受支持（请检查代码是否正确，如日语用 jp 而非 ja） |
| `5020` | `—` | 服务翻译服务不可用 |
| `5030` | `—` | 翻译服务密钥未配置，请联系管理员 |

## 9. 变更日志

- **v2.0** (2026-06-04)
  - 支持 19 种语言互译（含粤语、文言文）。
  - 参数 q 与 text 均兼容；语言代码采用 jp(日语)/kor(韩语)/fra(法语)/spa(西班牙语)。
- **v1.0** (2025-01-01)
  - 首次上线，支持多语种互译。

---

**极数本源** · 全部 API: `https://apizero.cn/aidocs` · 人类版本：`https://apizero.cn/marketplace/translate`

Source: `https://apizero.cn/aidocs/translate/raw.md`
Last updated: 2026-08-10T05:57:08+08:00