文本翻译Text Translation

将文本从源语言翻译为目标语言，支持 49 种语言、自动语言检测、正式/非正式语气控制、术语库管理、HTML/XML 标签保留及上下文优化。Translate text from source to target language. Supports 49 languages, auto-detection, formality control, glossary management, HTML/XML tag preservation, and context enhancement.

请求端点

Endpoint

认证

Authentication

需要 OAuth 2.0 Bearer Token。Requires OAuth 2.0 Bearer Token. 查看认证说明See Authentication

Authorization: Bearer {access_token}

请求头

Request Headers

请求参数

Request Parameters

快速开始

Quick Start

curl -X POST https://api.itranslator.cc/v1/translate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "人工智能正在改变世界。",
    "source_lang": "zh",
    "target_lang": "en"
  }'

import requests

url = "https://api.itranslator.cc/v1/translate"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "text": "人工智能正在改变世界。",
    "source_lang": "zh",
    "target_lang": "en"
}

resp = requests.post(url, json=data, headers=headers)
print(resp.json())

const url = "https://api.itranslator.cc/v1/translate";

const resp = await fetch(url, {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    text: "人工智能正在改变世界。",
    source_lang: "zh",
    target_lang: "en"
  })
});

const data = await resp.json();
console.log(data);

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.itranslator.cc/v1/translate"))
    .header("Authorization", "Bearer YOUR_API_TOKEN")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("""
        {"source_lang":"zh","target_lang":"en","text":"人工智能正在改变世界。"}
    """))
    .build();
HttpResponse<String> response = client.send(request,
    HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

批量翻译

Batch Translation

将 text 参数设为字符串数组，即可在一次请求中翻译多条文本。响应中的 translations 数组与输入顺序一一对应。

Set text to a string array to translate multiple texts in one request. The translations array maps 1:1 to input order.

curl -X POST https://api.itranslator.cc/v1/translate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": ["你好", "谢谢", "再见"],
    "target_lang": "en"
  }'

{
  "translations": [
    { "detected_source_language": "zh", "text": "Hello" },
    { "detected_source_language": "zh", "text": "Thank you" },
    { "detected_source_language": "zh", "text": "Goodbye" }
  ],
  "billed_characters": 6
}

语气控制

Formality Control

通过 formality 参数控制译文正式程度。在不支持的语言中，prefer_more/prefer_less 会自动回退为 default，不会报错。

Control translation formality with formality. For unsupported languages, prefer_more/prefer_less silently fall back to default.

正式/非正式语气在以下目标语言中可用：中文、英语、日语、韩语、法语、德语、西班牙语、意大利语、葡萄牙语、荷兰语、俄语、波兰语。

Formality is supported for target languages: Chinese, English, Japanese, Korean, French, German, Spanish, Italian, Portuguese, Dutch, Russian, Polish.

日语 formality 对比

Japanese Formality Comparison

HTML/XML 标签处理

HTML/XML Tag Handling

设置 tag_handling 为 html 或 xml 后，API 会识别输入中的标签结构，将标签放到译文正确位置，仅翻译标签外的文本。

With tag_handling set to html or xml, the API recognizes tag structures, places tags correctly in the translation, and only translates text outside tags.

HTML 翻译

HTML Translation

curl -X POST https://api.itranslator.cc/v1/translate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "<p>Welcome to <strong>iTranslator</strong></p>",
    "source_lang": "en",
    "target_lang": "zh",
    "tag_handling": "html"
  }'

{
  "translated_text": "<p>欢迎使用<strong>iTranslator</strong></p>",
  "source_lang": "en",
  "target_lang": "zh",
  "char_count": 15
}

忽略指定标签

Ignore Specific Tags

ignore_tags 指定不翻译的标签，标签内文本保留原文，适用于代码块、变量名等场景。

ignore_tags specifies tags whose content should not be translated. Useful for code blocks, variable names, etc.

curl -X POST https://api.itranslator.cc/v1/translate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "<p>Run <code>npm install</code> to start.</p>",
    "source_lang": "en",
    "target_lang": "zh",
    "tag_handling": "html",
    "ignore_tags": ["code"]
  }'

{
  "translated_text": "<p>运行 <code>npm install</code> 开始。</p>",
  "source_lang": "en",
  "target_lang": "zh",
  "char_count": 15
}

上下文增强

Context Enhancement

context 参数传入额外上下文，帮助消除歧义、选择更准确的译法。适合短文本、一词多义的场景。

The context parameter provides additional context to disambiguate meanings and improve translation accuracy. Ideal for short texts or polysemous terms.

curl -X POST https://api.itranslator.cc/v1/translate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "bank",
    "source_lang": "en",
    "target_lang": "zh",
    "context": "The river flows past the bank where people sit and fish."
  }'

{
  "translated_text": "河岸",
  "detected_source_language": "en",
  "target_lang": "zh",
  "char_count": 4
}

响应字段

Response Fields

响应示例

Response Examples

基础翻译（指定源语言）

Basic (source specified)

{
  "translated_text": "Artificial intelligence is changing the world.",
  "source_lang": "zh",
  "target_lang": "en",
  "char_count": 10
}

自动检测源语言

Auto-detect Source

{
  "translated_text": "Guten Morgen",
  "detected_source_language": "en",
  "target_lang": "de",
  "char_count": 12
}

术语库 + 语气控制

Glossary + Formality

{
  "translated_text": "当社は、お客様情報の保護に細心の注意を払っております。",
  "source_lang": "zh",
  "target_lang": "ja",
  "char_count": 14,
  "formality": "prefer_more",
  "glossary_id": "a3f8c2e1-4d56-7890-abcd-ef1234567890"
}

错误码

Error Codes

使用说明

Notes