讯飞额度被谁吃光了：四层限制分辨法与隐形消费者排查

先说一个我们花了很久才纠正的认知错误：把 licc failed 直接当成"额度用尽"。

这个错误很贵。它会导致两个方向的误判——要么在额度其实充足的时候白白买了服务量，要么在真正的瓶颈（并发）上一直找不到原因，最后得出"讯飞不稳定"的结论。实际情况是：讯飞给一个 APPID 的限制不是一个数字，而是四层，每一层的表现、恢复方式、解决办法都不同。

这篇文章是我们在一套多台数字人的生产环境里做额度对账的完整方法——不登控制台也能出结论，全部数据为一手实测。

一、licc failed 有三种可能，先分辨再下结论

语音合成/识别报 code=11201 或 11203 licc failed 时，它同时可能表示三件完全不同的事：

• 并发占满——别人正在用，名额满了；
• 额度用尽——当日配额或总量耗尽；
• 授权到期/未授权——某个发音人（vcn）的授权失效。

看到报错就先判定"额度没了"，是最常见的错。三步就能分辨：

1. 立刻重试一次。重试成功 = 并发占满（对方说完就空出名额）；持续失败 = 额度或授权问题。
2. 看是不是连"永久免费授权"的发音人也一起失败（比如普通话的 xiaoyan，授权到 2099 年）。连它都失败，说明是账号级的额度/服务量问题，而不是某一个音库没授权。
3. 跨 0 点前后各抓一次事件时间戳。0 点后自动恢复 = 每日配额（等重置就好，别买）；0 点后依然失败 = 总量或到期，这时候才需要考虑购买。

二、讯飞的限制是四层，不是一条

下面这张表是我们环境里实际被卡过的四层，注意每一层的瓶颈位置完全不同：

回答"有没有额度限制"时，必须按这四层分开答，否则一定答错。最常见的错误就是把第 1 层的"并发占满"说成第 3 层的"额度用尽"。

三、实测并发上限：必须"严格同时"才测得出来

并发这种事，串行发请求是测不出来的——前一个请求早就返回了，当然次次成功。必须用 Barrier 让所有线程在同一个点上对齐，再同时发出去。

import threading, sys, os
sys.path.insert(0, os.path.expanduser("~/digital_human"))
import asr_helper

wav = "/tmp/ctest.wav"          # 一段 1~2 秒的真实语音（太短会误判）
N = 4                            # 想验证的并发数
barrier = threading.Barrier(N); res = [None]*N

def worker(i):
    barrier.wait()               # ★ 关键：所有线程在此对齐后再同时发
    try:    res[i] = ("OK", asr_helper._xunfei_mulacc_transcribe(wav))
    except Exception as e: res[i] = ("FAIL", str(e)[:110])

ts = [threading.Thread(target=worker, args=(i,)) for i in range(N)]
[t.start() for t in ts]; [t.join() for t in ts]
print(res)

跑之前确认没有生产流量在说话（日志里最近的 ASR 事件数接近 0），并用 nice 降优先级；音频取 1~2 秒，整个过程 2 秒内结束，对线上影响可以忽略。

我们的实测结果（2026-09-15，本集群）：N=4 → 2 个成功、2 个失败，失败的在 0.14 秒内就返回了。这个 0.14 秒很关键——它是"被平台直接拒绝"，而不是"处理超时"，正好印证了并发上限的存在。

四、离线估算消耗：不用登控制台，但 grep 有个死穴

计费口径很简单：日志里一次合成事件 = 一次计费。本地日志就够用，不必登控制台。但计数方法有个坑，踩了会得到恒为 0 的假结果。

# ✅ 今日 TTS 计费次数：用【带时间戳】的行计数
grep -a "$(date +%Y-%m-%d)" ~/fullbody_dh/fullbody_dh.log | grep -ac '音量增强完成'

# ✅ 产线自记（跨重启不清零，最可靠）
cat ~/suzhou_voice_corpus/tools/daily_counter.json

死穴：[tts_helper] … 这类行没有时间戳。它是子进程 print 直接混进日志的，所以"按日期 grep"永远返回 0 行，看起来就像"今天没消耗"。正确做法是锚点法：先找到事件行，再向后找第一条能匹配 ^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2} 的行，用它的时间当作事件时间。

同理，grep -c 'ASR 耗时' 是可靠的（那行自带时间戳），但动手前必须先确认目标行的格式——别凭直觉写正则。

五、找"谁偷吃了额度"：第一步永远是 crontab -l

判断消耗来源，先看规律性：规律性的 = 定时任务；真实对话的时间戳是散的。所以第一步不是翻日志，是看计划任务。

我们环境里抓到的最大隐形消费者，是一条看起来人畜无害的巡检：

*/15 * * * *  selfcheck_xiaosu.py

它每 15 分钟跑一次，每次
① 合成 1 条自检输入音频；
② 把小苏的端到端回复逐句合成（2~3 句）。

算下来：96 次/天 × 3 条 = 288 次/天，正好是每日 500 次额度的 58%，同时还吃掉 96 次/天的 ASR。日志特征非常清晰：每刻的第 +7 秒出现 3 条合成（如 00:00:07 / 00:15:07 / 00:30:07）。

认知纠偏：「自检零 API 消耗」这句话只对"只读日志"的那部分检查成立。自检里的端到端断言——把音频真发给服务让它回复——是实实在在要烧 TTS 额度的。别把"没写 API 调用代码"当成"没有 API 消耗"。

六、停掉"吃额度"的定时任务：三件套，别删脚本

要停某个任务时，按这个顺序做，不要直接 crontab -r，也不要删脚本：

# ① 备份
crontab -l > ~/crontab.bak_$(date +%Y%m%d)_<原因>

# ② 注释掉原行（保留内容，可读可回溯）
crontab -l | sed 's|^\(<要停的那行特征>\)$|#DISABLED_$(date +%Y%m%d)_<who> \1|' | crontab -

# ③ 验证：活动 cron 里该行数应为 0
crontab -l | grep -v '^#' | grep -c '<脚本名>'

脚本文件保留不删——回滚只需要 crontab <备份文件>，比重写快得多也可靠得多。另外记得确认没有 systemd timer 在跑同一件事（systemctl list-timers --all）。

停用后要回算一次释放量并写进结论。我们这条停掉后：释放 288 次 TTS/天 + 96 次 ASR/天。注意代价：停掉自检会失去"方言掉档"的自动告警。如果仍想要告警，可以摘掉端到端合成部分、只保留只读日志的检查（零消耗），这是个可选的中间方案，不必非黑即白。

七、谁在烧额度：看引擎，别看角色名

多个数字人角色都"在说话"，不代表都在烧同一家的额度。要直接读各节点的 TTS 实现：

grep -nE 'edge_tts|XUNFEI|vcn|Xiaoxiao|VOICE' <节点>:<路径>/tts_helper.py

我们环境的实测结果（2026-09-15）：

这里有个极易踩的坑：我们曾以为"普通话角色用的是永久免费的普通话发音人，所以它占的是讯飞额度"。实测发现它根本没在调讯飞，走的是 edge_tts。把角色的"应该用什么"和"实际用什么"分开核，否则会同时犯两个错：把 edge_tts 的商用授权风险误当成讯飞音库配置问题，又把额度占用方算错了。

八、别把"流水线兜底"当成额度告警

日志里还有一类长得很像额度告警、其实无关的报错：

流式产出为空(reply=0段, audio=0段)，走串行兜底

这是回复流水线的告警，属于整条链路组装失败后的降级动作，与 TTS 额度无关。判据要分清两条：

• TTS 额度问题 → 出现 licc failed / 11201 / 11203；
• 流水线问题 → 出现 流式产出为空 / 走串行兜底。

九、"够不够用"的两个算法

1. 次数够不够：用集群单日 ASR 调用量（grep -c 'ASR 耗时' 今日）去除总量：5 万次 ÷ 日耗 = 可用天数。如果可用天数大于服务包的有效期天数，那么"次数"根本不是瓶颈，到期日才是。
2. 今天会不会爆：剩余 = 500 −（产线 + 在线业务 + 其他定时任务）。报"够用"之前必须把隐形消费者全部扣掉——只看业务量会严重高估余量。若需求大于余量就会爆，表现是掉档而非哑掉：告警文件出现（如 xiaosu_alert.flag）、日志最近一条变成兜底成功，0 点自动恢复。

十、四条纪律

• 只读优先。日志 + crontab + 本地计数器能回答大部分问题；控制台只在需要"精确剩余服务量余额"时才登（登录有人机验证风险）。
• 压测避峰。并发压测、额度实验一律 nice 降优先级，挑空闲窗口，绝不在生产高峰做。
• 给在线业务留量。任何批量任务与在线业务共用 APPID 时，必须把"留量"写进代码，重启不清零。
• 先分辨，再花钱。四层分开答、三步先分辨——绝大多数"额度告警"其实不需要你掏钱。

如果你正在做数字人、语音助手或方言 TTS 相关的项目，上面这套排查流程你不需要买任何东西就能自己跑一遍；站内也上架了可商用的方言语料资产，需要时可以直接取用。