游戏本地化Game Localization

专为游戏内容定制的本地化方案,支持 UI 文本、剧情对话、配音脚本、营销素材等全场景翻译。Tailored localization for games — covering UI text, story dialogue, voice scripts, marketing materials, and more.

请求端点

Endpoint

POST/v1/game/localization

请求参数

Request Parameters

参数Parameter类型Type必填Required说明Description
textstringrequired游戏文本Game text
content_typestringrequired类型:ui / dialogue / item_desc / skill / story / tutorialType: ui/dialogue/item_desc/skill/story/tutorial
source_langstringrequired源语言Source language
target_langsstring[]required目标语言列表,常用于一次性发布多语版本Target language list (multi-language release)
genrestringoptional游戏类型:rpg / fps / moba / casual / strategyGame genre: rpg/fps/moba/casual/strategy etc.
max_lengthintegeroptional字符长度限制(如 UI 按钮文字)Character length limit (e.g. UI button text)
tonestringoptional风格:epic / humorous / dark / cuteTone: epic/humorous/dark/cute

请求示例

Request Examples

curl -X POST https://api.itranslator.cc/v1/
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '"text": "The ancient dragon awakens from its thousand-year slumber.",
    "content_type": "story",
    "source_lang": "en",
    "target_langs": ["zh","ja","ko"],
    "genre": "rpg",
    "tone": "epic"'

响应示例

Response Example

{
  "original": "The ancient dragon awakens from its thousand-year slumber.",
  "translations": {
    "zh": "远古巨龙从千年沉睡中苏醒。",
    "ja": "古の龍が千年の眠りから覚める。",
    "ko": "고대의 용이 천 년의 잠에서 깨어난다."
  },
  "content_type": "story",
  "genre": "rpg",
  "tone": "epic"
}

Unity / Unreal 集成

Unity / Unreal Integration

提供 Unity Package 和 Unreal Plugin,可直接在引擎内调用翻译接口。结合 Open SDK 实现一键多语言打包。Unity Package and Unreal Plugin available for in-engine translation. Combine with Open SDK for one-click multi-language builds.

// Unity C# 示例
using iTranslator.SDK;

var client = new FanyiClient("YOUR_OAUTH_TOKEN");
var result = await client.GameLocalization.TranslateAsync(
    "Press Start to begin your adventure.",
    sourceLang: "en",
    targetLangs: new[] { "zh", "ja", "ko" },
    contentType: "ui",
    genre: "rpg"
);

错误码

Error Codes

HTTP Code错误码Error Code说明Description
2000成功Success
4001001参数错误,请检查必填参数和参数格式Invalid parameter; check required fields and format
4001002不支持的语言代码Unsupported language code
4012001认证失败,Token 无效或已过期Authentication failed; invalid or expired token
4032003无权限访问该资源Access denied; insufficient permissions
4133001请求文本超出长度限制(最大 50,000 字符)Text exceeds maximum length (50,000 chars)
4294001请求频率超限,请稍后重试Rate limit exceeded; please retry later
5005001服务器内部错误,请重试或联系技术支持Internal server error; retry or contact support
使用说明
  • 所有 API 请求均使用 HTTPS,建议开启 HTTP Keep-Alive 以提高性能。
  • All API requests use HTTPS; enable HTTP Keep-Alive for better performance.
  • 请勿在客户端代码中暴露 Access Token,建议通过后端代理调用。
  • Do not expose your Access Token in client-side code; use a backend proxy.
  • 推荐设置合理的超时时间(30 秒),并实现指数退避重试策略。
  • Set a reasonable timeout (30s) and implement exponential backoff for retries.