From 03ef916c263fd7819ffa6ec72471c5467b114608 Mon Sep 17 00:00:00 2001
From: Zhengshou Lai <lai.zhengshou@outlook.com>
Date: Sun, 2 Aug 2026 16:27:24 +0800
Subject: [PATCH] docs: document volc_tts api-key credential (new TTS auth)

---
 AGENTS.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index f128880..535a50c 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -49,7 +49,8 @@ skill 或其他脚本应通过上述命令定位资源，避免硬编码 `~/work
 
 ```bash
 mytoolkit env set secrets.api_keys.ark <key>
-mytoolkit env set secrets.volcengine.app_id <appid>
+mytoolkit env set secrets.api_keys.volc_tts <api_key>   # TTS 新版 API Key（X-Api-Key）
+mytoolkit env set secrets.volcengine.app_id <appid>      # STT 旧版应用凭证
 mytoolkit env set secrets.volcengine.access_token <token>
 mytoolkit env list              # 查看所有 key
 mytoolkit env export            # 导出为 shell export 语句
@@ -59,7 +60,7 @@ mytoolkit env export            # 导出为 shell export 语句
 
 ## 3. 语音合成 (TTS)
 
-通过火山引擎（豆包）WebSocket API 实现，命令为 `mytoolkit voice tts`。
+通过火山引擎（豆包）API 实现，命令为 `mytoolkit voice tts`。TTS 优先用新版 **API Key**（`secrets.api_keys.volc_tts`，`X-Api-Key` 鉴权，HTTP 端点），旧版 `secrets.volcengine.app_id` / `access_token` 仅作回退。
 
 配置方式见上方 §2 配置管理。
 
@@ -79,7 +80,7 @@ mytoolkit voice tts "文本" -v zh_female_xiaohe_uranus_bigtts --format mp3 --sp
 
 ### 语音识别 (STT)
 
-豆包录音文件识别极速版（flash ASR），与 TTS 共用同一组 Volcengine 凭证：
+豆包录音文件识别极速版（flash ASR），STT 仍用旧版 `secrets.volcengine.app_id` / `access_token`（TTS 已改用 `secrets.api_keys.volc_tts`）：
 
 ```bash
 mytoolkit voice stt -i clip.webm