任务恢复与计费

提交前保留幂等键

kitta audio tts --voice VOICE_ID --text-file script.txt --idempotency-key narration-001 --output narration.mp3

每个新的业务操作使用新的键；恢复同一次提交时保持输入与键不变。不要把示例键当成所有任务通用的键。

CLI 在提交前保存键和请求指纹，不保存文本或 API Key。默认记录位于 ~/.config/kitta/submissions，可用 KITTA_CONFIG_DIR 指定目录。已保存任务 ID 时，重跑会查询任务；相同键与不同输入会在本地失败。

已获得任务 ID

kitta audio jobs get --job TASK_ID
kitta audio jobs wait --job TASK_ID --wait-timeout 600
kitta audio jobs download --job TASK_ID --output recovered.mp3

这些命令不会创建新的 TTS 任务。选择未使用的输出文件名。成功下载后再使用音频。

结果未知

没有收到任务 ID 时，以相同输入和幂等键重试；恢复仍受服务端幂等记录保留期限约束，不能承诺无限期去重。换新键代表一笔新的付费请求。

Ctrl+C、网络错误和本地超时不会取消已接受的远程任务，也不代表退款。查询账号使用记录以确定实际计费；dry-run 不估价、不查询额度。

读取请求和幂等 TTS 创建会对暂时性错误自动重试最多两次。转写、克隆、设计等其他付费操作不会自动重试；结果未知时先核对账号，不要盲目重提。

下一步： 快速开始.