无

无量翻译

WULIANG TRANSLATE · 文本 / 语音 / 图像 / 文档 / 同传

K1 · 主密钥

引擎：彩云小译 Lingocloud · device_id / request_id 由服务端自动生成（UUID）

语音合成 TTS

/v1/tts · 已验证

上游 TTS 服务异常时将自动回退到浏览器本地语音合成，保证功能可用。

图片翻译 已验证 · protobuf

上游 /v1/image_translator（subscription-key 鉴权）。图片前端压缩 JPEG 90% 后由服务端封装 protobuf（PictureProto.Image_info）上传，结果区展示识别原文/译文及标注图。


    

  


  
  

    

      
网页翻译 需官方账号

      
官方端点 /v1/page/auth 实测拒绝匿名密钥（Bad user），需彩云小译登录账号，暂不可用。

      

        
        
        
      

      

    

  


  
  

    

      
AI 对话 需官方账号

      
依附网页翻译会话（/v1/page/{id}/conversation/chat），同样需登录账号，暂不可用。

      

      

        
        
      

    

  


  
  

    

      
同声传译 已验证 · K3 · WebSocket · PCM 16kHz

      

        
        
        
        
        
        
        未连接
      

      

      
上游 wss://interpreter.cyapi.cn/v1/speech_translator?source_lang=&target_lang=&mode=（经 APK 反编译确认并实测端到端可用）。子协议：x-authorization#K3,if_interim_results#false,trans_interval#12,app#android；音频：浏览器采集 → 降采样 PCM 16kHz → 二进制帧中继，停止时发送 end_websocket 文本帧。

    

  


  
  

    

      
接口与密钥总览

      
本站采用后端代理架构：所有密钥仅存于服务器环境变量（/opt/wuliang/.env，权限 600），浏览器端只见脱敏值。官方调用方式详见 彩云小译 API 文档 与 彩云开放文档站。

      
1. 密钥清单（脱敏）

      

        
编号密钥值授权范围

        
          
K19sdf****...****n2l主密钥：文本翻译、词典、图片翻译（OCR）、文档翻译、新闻、TTS、用户/商品/兑换全接口

          
K2neh2****...****c0h5网页翻译 + AI 对话

          
K3ejlj****...****t4l4同声传译 WebSocket（实时语音识别 + 翻译）

          
K4/K5appid=5832**** / 210a****...****792a讯飞中文 ASR/TTS + 英文引擎（备用语音通道）

        
      

      
2. 请求模板

      
# HTTP 头（双头同发）
Authorization: token $K1
X-Authorization: token $K1
os-type: android
App-Name: com.caiyun.interpreter
X-Request-Id: <UUID>
Device-Id: <UUID>
# 图片翻译额外：subscription-key: $K1

# Body
{"source":"文本","trans_type":"en2zh","device_id":"...","request_id":"...","dict":false,"media":"text"}

      
# WebSocket 子协议
Sec-WebSocket-Protocol: x-authorization#$K3,if_interim_results#false,trans_interval#12,app#android
URL 携带语言参数（source_lang / target_lang）；音频流：PCM 16kHz 二进制帧

      
3. 接口与域名清单

      

        
环境地址说明

        
          
官方开放平台https://api.interpreter.caiyunai.com/v1/translator文档化端点，本站默认翻译上游 ✅ 已验证

          
生产https://interpreter.cyapi.cnApp 后端 ✅ 已验证可用

          
灰度https://lingocloud.caiyunapp.com✅ 已验证可用

          
测试https://api-interpreter-develop.ccluster.net开发调试环境

          
TTShttps://api.interpreter.caiyunai.com/v1/tts✅ 已验证：返回 wav 音频（16bit 单声道 16kHz），17 语种

          
图片翻译https://interpreter.cyapi.cn/v1/image_translator✅ 已验证：protobuf 请求/响应，subscription-key 鉴权

          
同传 WSwss://interpreter.cyapi.cn/v1/speech_translator✅ 已验证：PCM 流式推送，返回 recognizing/recognized 事件

          
网页翻译/AI 对话/v1/page/auth、/v1/page/{id}/conversation/chat❌ 需真实登录账号（匿名密钥返回 Bad user）

          
文档翻译/v1/doc/translate❌ 需真实登录账号（匿名调用返回 400）

        
      

      
4. 客户端可控字段

      
device_id / request_id / user_id / Cy-User-Id 全部由客户端生成。本站由后端统一生成 UUID，便于日志追踪与防重放。

      
5. 协议细节

      
    
        
  • 图片翻译请求体为 protobuf：PictureProto.Image_info，图片先压缩为 JPEG（质量 90%）再封装。
    • 
        
  • 同传 WS 子协议以 # 分隔键值、逗号分隔参数。
    • 
        
  • 语音流：PCM 无头裸流，16kHz、16bit、单声道。
    • 
      

      
6. 本站后端路由

      

        
路由方法密钥对应能力

        
          
/api/translatePOSTK1文本翻译 + 词典字段

          
/api/ttsPOSTK1语音合成（返回 wav 二进制）✅

          
/api/imagePOSTK1图片翻译（服务端 protobuf 封装/解析）✅

          
/api/furiganaPOSTK1日语振假名 ✅

          
/api/newsGETK1双语资讯 ✅

          
/api/documentPOSTK1文档翻译（需登录，返回 501）

          
/api/webpagePOSTK2网页翻译（需登录，返回 501）

          
/api/chatPOSTK2AI 对话（需登录，返回 501）

          
/ws/interpretWSK3同声传译中继 ✅

        
      

    

  


  
  

    

      
GitHub 开源生态（可完善本站）

      

      
以上项目均原生支持彩云小译 API，可借鉴其：划词/批量翻译交互（Easydict、Saladict 类）、浏览器扩展架构（ttttmr/Caiyun）、多引擎抽象（translators）、桌面端插件机制（Bob / Pot）。