用于 Coding Agent

准备

先安装 CLI。Schema 与 Skills 生成无需密钥；执行真实付费操作前由你配置账号认证。不要把密钥粘贴给编程助手。

kitta skills generate --api-url https://fishaudio.org --output-dir .agents/skills/kitta-audio
kitta audio tts --api-url https://fishaudio.org --schema

检查生成的 Skills 文件，再按照所用编程助手的规则启用。写入目录本身不证明助手已经加载了技能。生成文件沿用通用 CLI 默认值，skills generate 不会保存本站地址；把下方本站指令与生成技能一起交给助手。

先检查输入

kitta audio tts --api-url https://fishaudio.org --voice VOICE_ID --text "Hello from Kitta" --dry-run

替换声音 ID。dry-run 在本地验证并展示请求，不访问网络，不写入提交记录。Authorization 被隐藏，但输入文本会显示在输出中。它不检查实时模型可用性、余额或价格。

推荐的助手规则

每次调用 CLI 都显式传入 --api-url https://fishaudio.org ，包括认证、生成、任务查询和恢复。只使用属于该地址的 API Key 和任务 ID。生成技能不会绑定站点，CLI 默认地址仍是 https://kittaai.com。

执行付费操作前，确认文本、声音、输出文件和操作范围。不要读取或展示密钥。为新 TTS 操作保留业务幂等键，恢复时使用原键和原输入。失败时报告任务 ID，不自动重提克隆、设计或转写。

CLI 提供终端工具与 Skills 文件，不应将其描述成已部署的 MCP 服务。

失败与下一步

参数无效时先修正输入，不进行真实提交。助手不知道远程结果时，先查询任务。 恢复指南 · 自动化