语种列表
查询 iTranslator 支持的所有语言及其本地化名称、ISO 代码与功能覆盖范围。该接口无需认证,建议客户端按需缓存。
请求端点
Endpoint
GET/v1/languages
💡 无需认证即可调用。建议在客户端缓存结果(有效期 24 小时),避免频繁请求。
查询参数
Query Parameters
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | string | optional | translation / speech / ocr,默认 translation |
| capability | string | optional | formality / glossary / document,筛出支持特定功能的语言 |
| source | string | optional | 传语言代码,仅返回可作为"源语言"翻译至此目标语的语言列表 |
| target | string | optional | 传语言代码,仅返回可作为"目标语言"来翻译的语言列表 |
请求示例
Request Examples
curl https://api.itranslator.cc/v1/languages?type=translation
# 查支持正式/非正式语气的翻译语言 curl https://api.itranslator.cc/v1/languages?type=translation&capability=formality # 查支持语音识别的语言 curl https://api.itranslator.cc/v1/languages?type=speech # 查可将英文译出的所有目标语言 curl https://api.itranslator.cc/v1/languages?type=translation&source=en
响应字段说明
Response Fields
| 字段 | 类型 | 说明 |
|---|---|---|
| code | string | ISO 639-1 两字母语言代码(小写) |
| name | string | 本地化语言名称(该语言自身的写法) |
| name_en | string | 英文语言名称 |
| supports_formality | boolean | 是否支持翻译结果的"正式/非正式"语气切换 |
| supports_glossary | boolean | 是否可作为术语库的语言对之一 |
| supports_speech | boolean | 是否支持语音识别 / 语音翻译 |
| supports_ocr | boolean | 是否支持图片 OCR 识别与翻译 |
| supports_document | boolean | 是否支持文档格式翻译 |
响应示例
Response Example
{
"languages": [
{
"code": "zh",
"name": "中文",
"name_en": "Chinese",
"supports_formality": true,
"supports_glossary": true,
"supports_speech": true,
"supports_ocr": true,
"supports_document": true
},
{
"code": "en",
"name": "English",
"name_en": "English",
"supports_formality": true,
"supports_glossary": true,
"supports_speech": true,
"supports_ocr": true,
"supports_document": true
},
{
"code": "ja",
"name": "日本語",
"name_en": "Japanese",
"supports_formality": true,
"supports_glossary": true,
"supports_speech": true,
"supports_ocr": true,
"supports_document": true
},
{
"code": "th",
"name": "ไทย",
"name_en": "Thai",
"supports_formality": false,
"supports_glossary": true,
"supports_speech": true,
"supports_ocr": false,
"supports_document": false
}
],
"total": 49
}支持的语言列表
Supported Languages
以下为 iTranslator 当前支持的 49 种语言及各自的功能覆盖情况。✅ 表示支持,— 表示暂不支持。
| 代码 | 语言 | 英文名 | 正式/非正式 | 术语库 | 语音 | OCR | 文档 |
|---|---|---|---|---|---|---|---|
| af | Afrikaans | Afrikaans | — | ✅ | — | — | — |
| sq | Shqip | Albanian | — | ✅ | — | — | — |
| ar | العربية | Arabic | — | ✅ | ✅ | ✅ | ✅ |
| hy | Հայերեն | Armenian | — | — | — | — | — |
| az | Azərbaycan | Azerbaijani | — | — | — | — | — |
| bn | বাংলা | Bengali | — | ✅ | ✅ | — | — |
| bg | Български | Bulgarian | ✅ | ✅ | ✅ | — | ✅ |
| my | မြန်မာဘာသာ | Burmese | — | — | — | — | — |
| ca | Català | Catalan | — | ✅ | ✅ | — | — |
| zh | 中文 | Chinese | ✅ | ✅ | ✅ | ✅ | ✅ |
| hr | Hrvatski | Croatian | — | ✅ | ✅ | — | — |
| cs | Čeština | Czech | ✅ | ✅ | ✅ | ✅ | ✅ |
| da | Dansk | Danish | ✅ | ✅ | ✅ | — | ✅ |
| nl | Nederlands | Dutch | ✅ | ✅ | ✅ | ✅ | ✅ |
| en | English | English | ✅ | ✅ | ✅ | ✅ | ✅ |
| et | Eesti | Estonian | ✅ | ✅ | ✅ | — | — |
| fi | Suomi | Finnish | ✅ | ✅ | ✅ | — | ✅ |
| fr | Français | French | ✅ | ✅ | ✅ | ✅ | ✅ |
| ka | ქართული | Georgian | — | — | — | — | — |
| de | Deutsch | German | ✅ | ✅ | ✅ | ✅ | ✅ |
| el | Ελληνικά | Greek | ✅ | ✅ | ✅ | ✅ | ✅ |
| he | עברית | Hebrew | ✅ | ✅ | ✅ | — | — |
| hi | हिन्दी | Hindi | ✅ | ✅ | ✅ | ✅ | ✅ |
| hu | Magyar | Hungarian | ✅ | ✅ | ✅ | ✅ | ✅ |
| is | Íslenska | Icelandic | — | — | — | — | — |
| id | Bahasa Indonesia | Indonesian | ✅ | ✅ | ✅ | ✅ | ✅ |
| it | Italiano | Italian | ✅ | ✅ | ✅ | ✅ | ✅ |
| ja | 日本語 | Japanese | ✅ | ✅ | ✅ | ✅ | ✅ |
| ko | 한국어 | Korean | ✅ | ✅ | ✅ | ✅ | ✅ |
| lv | Latviešu | Latvian | ✅ | ✅ | ✅ | — | — |
| lt | Lietuvių | Lithuanian | ✅ | ✅ | ✅ | — | — |
| ms | Bahasa Melayu | Malay | — | ✅ | ✅ | — | — |
| no | Norsk | Norwegian | ✅ | ✅ | ✅ | — | ✅ |
| fa | فارسی | Persian | — | ✅ | ✅ | ✅ | — |
| pl | Polski | Polish | ✅ | ✅ | ✅ | ✅ | ✅ |
| pt | Português | Portuguese | ✅ | ✅ | ✅ | ✅ | ✅ |
| ro | Română | Romanian | ✅ | ✅ | ✅ | — | ✅ |
| ru | Русский | Russian | ✅ | ✅ | ✅ | ✅ | ✅ |
| sr | Српски | Serbian | — | ✅ | ✅ | — | — |
| sk | Slovenčina | Slovak | ✅ | ✅ | ✅ | — | ✅ |
| sl | Slovenščina | Slovenian | ✅ | ✅ | ✅ | — | — |
| es | Español | Spanish | ✅ | ✅ | ✅ | ✅ | ✅ |
| sw | Kiswahili | Swahili | — | — | ✅ | — | — |
| sv | Svenska | Swedish | ✅ | ✅ | ✅ | — | ✅ |
| tl | Tagalog | Tagalog | — | — | ✅ | — | — |
| th | ไทย | Thai | — | ✅ | ✅ | — | — |
| tr | Türkçe | Turkish | ✅ | ✅ | ✅ | ✅ | ✅ |
| uk | Українська | Ukrainian | ✅ | ✅ | ✅ | ✅ | ✅ |
| vi | Tiếng Việt | Vietnamese | — | ✅ | ✅ | ✅ | ✅ |
源语言与目标语言
Source & Target Languages
同一语言作为 源语言(source) 和 目标语言(target) 时支持的功能可能不同:
- 自动检测 (
auto) 仅在源语言上下文中可用,可自动识别输入文本的语言。 - 正式/非正式语气 (formality) 仅影响目标语言的输出风格,源语言不受影响。
- 术语库 必须指定具体的源语言代码,不支持
auto。
语言变体
Language Variants
部分语言支持区域性变体。以下变体可作为目标语言使用,源语言自动映射为主代码。
| 语言 | 主代码 | 可用变体 |
|---|---|---|
| 英语 | en | en-US, en-GB |
| 葡萄牙语 | pt | pt-BR, pt-PT |
| 中文 | zh | zh-CN, zh-TW |
| 法语 | fr | fr-CA |
| 西班牙语 | es | es-MX |
| 荷兰语 | nl | nl-BE |
📌 使用建议
- 生产环境中请优先通过 API 动态获取语言列表,而非依赖本文档的静态数据。语言支持可能随时更新。
- 语言代码全为小写 ISO 639-1 两字母,请勿使用全大写或完整单词。
- 不同功能(翻译、语音、OCR、文档)的语言覆盖范围不同,请使用
type和capability参数按需筛选。
错误码
Error Codes
| HTTP Code | 错误码 | 说明 |
|---|---|---|
| 200 | 0 | 成功 |
| 400 | 1001 | 参数错误,请检查必填参数和参数格式 |
| 401 | 2001 | 认证失败,Token 无效或已过期 |
| 403 | 2003 | 无权限访问该资源 |
| 404 | 2004 | 资源不存在 |
| 409 | 1003 | 数据冲突,如重复创建同名记录 |
| 429 | 4001 | 请求频率超限,请稍后重试 |
| 500 | 5001 | 服务器内部错误,请重试或联系技术支持 |
iTranslator