离线翻译Offline Translation

下载翻译模型到本地部署,在无网络环境中使用 iTranslator 的全部翻译能力,满足数据安全与合规需求。提供 NMT 翻译、OCR 识别、ASR 语音识别等多种离线模型,支持 Docker 容器化部署和 GPU 加速,适用于金融、医疗、政府等数据不出网场景,以及嵌入式设备和网络不稳定环境。Download translation models for local deployment. Use iTranslator in air-gapped environments for data security and compliance. Offers NMT translation, OCR recognition, ASR speech recognition models with Docker containerized deployment and GPU acceleration. Ideal for finance, healthcare, government data-sensitive scenarios, embedded devices, and unstable network environments.

快速概览

Quick Overview

属性Attribute说明Description
模型列表端点Model List EndpointGET /v1/offline/models
模型下载端点Model Download EndpointGET /v1/offline/models/{model_id}/download
本地翻译端点Local Translate EndpointPOST /v1/translate(部署后本地调用)
认证AuthenticationBearer Token(云 API);本地部署免认证Bearer Token (cloud API); no auth for local deployment
模型类型Model TypesNMT 翻译 / OCR 识别 / ASR 语音识别NMT translation / OCR recognition / ASR speech recognition
部署方式DeploymentDocker 容器 / 二进制 / 库集成Docker container / binary / library integration
GPU 加速GPU Acceleration可选,NVIDIA CUDA 11+,CPU 亦可运行Optional; NVIDIA CUDA 11+; CPU also supported
网络要求Network仅下载模型时需联网,部署后完全离线运行Online only for model download; fully offline after deployment
💡 适用场景Use Cases 金融、医疗、政府等对数据出网有严格要求的行业;偏远地区网络不稳定环境;嵌入式设备集成;军事、涉密单位等完全隔离网络环境。 Finance, healthcare, government with strict data policies; remote areas with unstable connectivity; embedded device integration; military and classified networks with complete isolation.

获取可用模型列表

List Available Models

GET/v1/offline/models

认证

Authentication

云端 API 请求需在 HTTP Header 中携带 Access Token(下载模型时需要)。模型部署到本地后,本地 API 调用无需认证。

Cloud API requests require an Access Token in the HTTP Header (needed for model download). After local deployment, local API calls require no authentication.

Authorization: Bearer {access_token}

请求头

Request Headers

请求头Header必填Required说明Description
Authorizationrequired格式 Bearer {access_token},用于身份认证Format: Bearer {access_token}, used for authentication

查询参数

Query Parameters

参数Parameter类型Type说明Description
typestringoptional按类型筛选:nmt(翻译)/ ocr(识别)/ asr(语音)Filter by type: nmt / ocr / asr

模型列表

Model List

Model ID语言/能力Languages大小Size类型Type版本Version说明Notes
fanyi-nmt-base 通用 100+ 语言 General 100+ languages 1.2 GBNMTv2.4 全量模型,翻译质量最高,推荐服务器部署 Full model; highest quality; recommended for servers
fanyi-nmt-small 常用 30 语言 Common 30 languages 380 MBNMTv2.4 轻量模型,适合边缘设备和低资源环境 Lightweight model; for edge devices and low-resource environments
fanyi-nmt-zh-en 中英双向 ZH ↔ EN 520 MBNMTv2.4 中英专用优化模型,翻译质量优于通用模型 ZH-EN optimized; higher quality than general model
fanyi-ocr-v2 中英日韩 + 通用 ZH/EN/JA/KO + General 240 MBOCRv2.1 图片文字识别模型,支持印刷体和手写体 Image text recognition; supports printed and handwritten text
fanyi-asr-multilingual 50+ 语言 50+ languages 1.8 GBASRv3.0 语音识别模型,支持实时流式和批量识别 Speech recognition; supports real-time streaming and batch
fanyi-asr-zh 中文专用 Chinese only 680 MBASRv3.0 中文语音识别专用模型,准确率更高 Chinese-specific ASR; higher accuracy

模型列表响应示例

Model List Response Example

{
  "models": [
    {
      "model_id": "fanyi-nmt-base",
      "type": "nmt",
      "languages": "100+",
      "size_bytes": 1288490188,
      "version": "v2.4",
      "description": "通用 NMT 翻译模型,100+ 语言",
      "download_url": "https://api.itranslator.cc/v1/offline/models/fanyi-nmt-base/download",
      "updated_at": "2026-06-15T00:00:00Z"
    },
    {
      "model_id": "fanyi-nmt-small",
      "type": "nmt",
      "languages": "30",
      "size_bytes": 398458884,
      "version": "v2.4",
      "description": "轻量 NMT 翻译模型,30 种常用语言",
      "download_url": "https://api.itranslator.cc/v1/offline/models/fanyi-nmt-small/download",
      "updated_at": "2026-06-15T00:00:00Z"
    }
  ],
  "total": 6
}

查询模型详情

Get Model Details

GET/v1/offline/models/{model_id}

查询单个模型的详细信息,包括支持的语言列表、版本历史和下载地址。

Query detailed information about a single model, including supported languages, version history, and download URL.

curl -X GET https://api.itranslator.cc/v1/offline/models/fanyi-nmt-base \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
  "model_id": "fanyi-nmt-base",
  "type": "nmt",
  "languages": ["zh", "en", "ja", "ko", "de", "fr", "es", "..."],
  "language_count": 104,
  "size_bytes": 1288490188,
  "version": "v2.4",
  "description": "通用 NMT 翻译模型,支持 100+ 语言互译",
  "min_ram": "4 GB",
  "gpu_optional": true,
  "download_url": "https://api.itranslator.cc/v1/offline/models/fanyi-nmt-base/download",
  "checksum": "sha256:a1b2c3d4e5f6...",
  "updated_at": "2026-06-15T00:00:00Z",
  "versions": [
    { "version": "v2.4", "updated_at": "2026-06-15T00:00:00Z", "changelog": "优化小语种翻译质量" },
    { "version": "v2.3", "updated_at": "2026-03-10T00:00:00Z", "changelog": "新增 5 种非洲语言" }
  ]
}

下载模型

Download Model

GET/v1/offline/models/{model_id}/download

下载模型压缩包(.tar.gz 格式),下载后解压到本地 models 目录即可使用。建议下载后校验 checksum 确保文件完整性。

Download the model archive (.tar.gz); extract to the local models directory. Verify checksum after download for integrity.

# 下载模型
curl -o fanyi-nmt-base.tar.gz \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  https://api.itranslator.cc/v1/offline/models/fanyi-nmt-base/download

# 解压到 models 目录
tar -xzf fanyi-nmt-base.tar.gz -C ./models

# 校验文件完整性
sha256sum ./models/fanyi-nmt-base/model.bin
下载说明
  • 模型文件较大,建议使用 stream 模式下载,避免内存溢出
  • Models are large; use stream mode to avoid memory overflow
  • 下载链接有效期 24 小时,过期后需重新获取
  • Download links expire in 24 hours; re-fetch if needed
  • 支持断点续传,下载中断后可使用 Range 请求头继续
  • Supports resume; use Range header to continue interrupted downloads

请求示例

Request Examples

curl "https://api.itranslator.cc/v1/offline/models?type=nmt" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

本地部署 / Docker

Local Deploy via Docker

推荐使用 Docker 部署离线翻译服务,支持 CPU 和 GPU 两种镜像。部署后通过本地 HTTP 接口调用,无需联网。

Deploy the offline translation service via Docker, with both CPU and GPU images. After deployment, call via local HTTP API without internet.

CPU 部署

CPU Deployment

docker pull itranslator/offline-server:latest
docker run -d \
  --name itranslator-offline \
  -p 8080:8080 \
  -v ./models:/models \
  -e MODEL_PATH=/models/fanyi-nmt-base \
  -e MAX_WORKERS=4 \
  --restart unless-stopped \
  itranslator/offline-server:latest

# 查看服务状态
docker logs -f itranslator-offline

# 本地调用(无需认证)
curl -X POST http://localhost:8080/v1/translate \
  -H "Content-Type: application/json" \
  -d '{"source_lang":"zh","target_lang":"en","text":"你好世界"}'

GPU 部署(NVIDIA)

GPU Deployment (NVIDIA)

docker pull itranslator/offline-server:latest-gpu
docker run -d \
  --name itranslator-offline-gpu \
  -p 8080:8080 \
  --gpus all \
  -v ./models:/models \
  -e MODEL_PATH=/models/fanyi-nmt-base \
  -e DEVICE=cuda \
  -e MAX_WORKERS=8 \
  --restart unless-stopped \
  itranslator/offline-server:latest-gpu

Docker Compose 部署

Docker Compose

# docker-compose.yml
version: "3.8"
services:
  itranslator-offline:
    image: itranslator/offline-server:latest
    ports:
      - "8080:8080"
    volumes:
      - ./models:/models
    environment:
      - MODEL_PATH=/models/fanyi-nmt-base
      - MAX_WORKERS=4
      - LOG_LEVEL=info
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
      interval: 30s
      timeout: 10s
      retries: 3

# 启动
docker-compose up -d

环境变量配置

Environment Variables

变量Variable默认值Default说明Description
MODEL_PATH必填Required模型目录路径,如 /models/fanyi-nmt-baseModel directory path, e.g. /models/fanyi-nmt-base
DEVICEcpu推理设备:cpu / cudaInference device: cpu / cuda
MAX_WORKERS4最大并发工作线程数Max concurrent worker threads
MAX_BATCH_SIZE32批量推理最大句子数Max sentences per batch inference
LOG_LEVELinfo日志级别:debug / info / warn / errorLog level: debug / info / warn / error
LISTEN_PORT8080服务监听端口Service listen port

本地 API 参考

Local API Reference

服务部署后,通过本地 HTTP 接口调用翻译能力,接口与云端 文本翻译 API 兼容。

After deployment, call translation via local HTTP API, compatible with the cloud Text Translation API.

POSThttp://localhost:8080/v1/translate
参数Parameter类型Type必填Required说明Description
textstringrequired待翻译文本,最大 5000 字符Text to translate, max 5000 chars
source_langstringrequired源语言代码,auto 为自动检测Source language code; auto for auto-detection
target_langstringrequired目标语言代码Target language code
curl -X POST http://localhost:8080/v1/translate \
  -H "Content-Type: application/json" \
  -d '{
    "text": "人工智能正在改变世界",
    "source_lang": "zh",
    "target_lang": "en"
  }'
{
  "translated_text": "Artificial intelligence is changing the world",
  "source_lang": "zh",
  "target_lang": "en",
  "detected_lang": "zh",
  "processing_time_ms": 85
}
💡 云端与本地 API 对比
  • 本地 API 免认证,响应更快(无网络延迟),适合内网环境
  • Local API requires no auth, faster response (no network latency); ideal for intranet
  • 云端 API 支持更多语言和高级特性(术语库、翻译记忆库、润色等)
  • Cloud API supports more languages and advanced features (glossary, TM, polishing)
  • 建议重要数据走本地,非敏感内容走云端以获得更优翻译质量
  • Route sensitive data locally; non-sensitive content via cloud for better quality

系统要求

System Requirements

MinimumRecommended
操作系统OSLinux x86_64 / macOSUbuntu 22.04 / CentOS 8+
CPU4 cores8+ cores
内存RAM4 GB16 GB
磁盘Disk10 GB50 GB SSD
GPU可选OptionalNVIDIA CUDA 11+ / 8GB VRAM
Docker20.10+24.0+(推荐 Compose v2)
网络Network仅下载时需要部署后完全离线
性能参考
配置Config吞吐量Throughput延迟Latency
4 核 CPU + 4GB~200 字/秒~200 chars/s~50ms
8 核 CPU + 16GB~500 字/秒~500 chars/s~30ms
GPU RTX 3090~3000 字/秒~3000 chars/s~15ms

错误码

Error Codes

HTTP Code错误码Error Code说明Description
2000成功Success
4001001参数错误,请检查必填参数和参数格式Invalid parameter; check required fields and format
4001002不支持的语言代码Unsupported language code
4001017模型 ID 不存在或不可用Model ID does not exist or is unavailable
4001018模型与指定语言不兼容,该模型不支持此语言对Model incompatible with the specified language pair
4012001认证失败,Token 无效或已过期Authentication failed; invalid or expired token
4032003无权限访问该资源或未开通离线 SDK 权限Access denied; insufficient permissions or offline SDK not enabled
4042005模型文件不存在或下载链接已过期Model file not found or download link expired
4133001请求文本超出长度限制(最大 50,000 字符)Text exceeds maximum length (50,000 chars)
4294001请求频率超限,请稍后重试Rate limit exceeded; please retry later
4564002套餐配额已用尽,请升级或等待重置Plan quota exhausted; upgrade or wait for reset
5005001服务器内部错误,请重试或联系技术支持Internal server error; retry or contact support
5035002服务暂时不可用,建议稍后重试Service temporarily unavailable; retry later

最佳实践

Best Practices

  1. 按需选择模型:仅需中英翻译选 fanyi-nmt-zh-en,多语言选 fanyi-nmt-base,资源受限设备选 fanyi-nmt-small
  2. Choose Model by Need: Use fanyi-nmt-zh-en for ZH-EN, fanyi-nmt-base for multi-language, fanyi-nmt-small for resource-constrained devices.
  3. GPU 加速提升吞吐:高并发场景部署 GPU 版本,吞吐量可达 CPU 的 6~10 倍,延迟降低 50%+。
  4. GPU for Throughput: Deploy GPU for high-concurrency scenarios; throughput 6~10x CPU, latency reduced 50%+.
  5. 模型版本管理:定期查询模型详情接口检查更新,新版本通常提升翻译质量,更新时建议灰度切换。
  6. Model Versioning: Regularly check the model details API for updates; new versions typically improve quality; use canary deployment for updates.
  7. 校验文件完整性:下载后务必校验 checksum,避免传输损坏导致模型加载失败。
  8. Verify Integrity: Always verify checksum after download to prevent model load failures from corruption.
  9. 健康检查:Docker 部署配置 healthcheck,定期访问 /health 端点监控服务可用性。
  10. Health Checks: Configure Docker healthcheck; regularly access /health endpoint to monitor availability.
  11. 混合部署策略:敏感数据走本地离线服务,非敏感内容走云端 API 获得更优翻译质量和高级特性。
  12. Hybrid Strategy: Route sensitive data to local offline service; non-sensitive content via cloud API for better quality and features.

应用场景

Use Cases

场景Scenario推荐模型Recommended Model说明Notes
🏦 金融/银行 Finance/Banking fanyi-nmt-zh-en fanyi-nmt-zh-en 内网部署,合同/报告翻译不出网,满足合规审计要求 Intranet deployment; contracts/reports stay on-premise for compliance
🏥 医疗/病历 Healthcare fanyi-nmt-base fanyi-nmt-base 病历、处方本地翻译,保护患者隐私数据 Local translation of medical records and prescriptions; protects patient privacy
🏛️ 政府/涉密 Government/Classified fanyi-nmt-base + OCR fanyi-nmt-base + OCR 完全隔离网络环境,文档翻译+图片识别全程离线 Fully isolated network; document translation and OCR entirely offline
📡 边缘设备 Edge Devices fanyi-nmt-small fanyi-nmt-small 低资源嵌入式设备,轻量模型占用小、启动快 Low-resource embedded devices; small footprint, fast startup
🌐 多语言客服 Multi-language CS fanyi-nmt-base + ASR fanyi-nmt-base + ASR 本地语音识别+翻译,实时多语言客服无网络依赖 Local ASR + translation; real-time multi-language customer service without network
📦 离线翻译机 Offline Translator Device fanyi-nmt-small + ASR fanyi-nmt-small + ASR 便携翻译设备,无网环境下语音实时翻译 Portable translator device; real-time speech translation without network
使用说明
  • 所有 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.