LingoFlow 快速上手：用 TyDash 账号做意群翻译

LingoFlow 是 TyDash 旗下的异步意群翻译工作流：把长文切成意群，逐块翻译，保留上下文， 可选配音与时间轴。它与 TyDash 共用同一套账号，不需要单独注册。

1. 登录

打开 https://app.tydash.net/lingoflow/。

• 已登录 tydash.net → 同域 Cookie 直接生效；
• 未登录 → 跳转 TyDash 登录页，登录后回到 LingoFlow；
• 境内也可以走 https://app.tydash.cn/（301 到国际站）。

内测阶段仅对团队成员与受邀账号开放。

2. 在界面里提交第一篇

1. 新建文章，粘贴原文（建议先试 1–2 段）；
2. 选择目标语言；
3. 语音合成（TTS）当前未开通：保持关闭即可，文本翻译不受影响；
4. 提交后页面会显示 prepare → plan → translate → assemble → done 的阶段与进度。

作业完成后可以查看逐段译文、导出结果；额度在右上角账户页可见。

3. 用鸿渐 API Key 调用（给应用集成）

不需要 LingoFlow 账号：鸿渐把作业接口作为服务代理，鉴权/配额/审计都用 sk-hj-…。

# 1) 估算（注意字段名是 content，不是 text）
curl https://hugen.tydash.net/v1/lingoflow/estimate \
  -H "Authorization: Bearer $HUGEN_KEY" \
  -H 'content-type: application/json' \
  -d '{"content":"The quick brown fox jumps over the lazy dog."}'

# 2) 提交作业（不传 options.audio = 只做文本）
curl https://hugen.tydash.net/v1/lingoflow/jobs \
  -H "Authorization: Bearer $HUGEN_KEY" \
  -H 'content-type: application/json' \
  -d '{"content":"...","title":"my-first-job","target_language":"zh"}'
# → 202 {"job_id":"job_...","article_id":"...","status":"pending","estimate":{...}}

# 3) 轮询
curl https://hugen.tydash.net/v1/lingoflow/jobs/<job_id> \
  -H "Authorization: Bearer $HUGEN_KEY"

成功时 status=succeeded、stage=done，result 里包含 has_translation、chunks_count、 alignment_method 等字段。

4. 关于音频

生产环境目前没有配置 TTS 供应商（openrouter_api_key 缺失），因此：

请求	行为
不传 options.audio	默认只做文本（LINGOFLOW_AUDIO_ENABLED=false）
options.audio=false	只做文本
options.audio=true	422 audio_unavailable，在扣费前拒绝，不会产生费用

配置 TTS 密钥并重启 lingo-api 后即可开启配音；接口形状不变。

5. 计费与失败

• 估算返回 chars / credits / available；提交时按估算预扣，失败会退回；
• 上游 LLM 失败会标记 retryable，按指数退避重试；
• 每个作业都有 request_id 与阶段日志，便于排查。

flowchart LR
  A["你的应用"] -->|"POST /v1/lingoflow/jobs"| H["hugen-api"]
  H -->|"服务身份"| L["lingo-api"]
  L --> Q[("jobs 队列")]
  Q --> W["worker：意群 → 翻译 → 组装"]
  W -->|"成功"| R["结果 + 用量"]
  W -->|"可重试失败"| Q
  H -->|"轮询/SSE"| A