SuperAPI AI 工具集

speak-common-errors

编程与开发

查看项目

更新于 10-15 23:30

技能介绍

用途:该技能用于诊断并修复 Speak API 的常见错误,包括认证失败、音频格式问题、速率限制和会话管理问题,适合在实现 Speak API 集成时排查故障。

主要能力:提供 HTTP 错误码对照表,涵盖 400(audio_format_invalid、audio_too_short、audio_too_long、language_not_supported)、401(invalid_api_key)、403(quota_exceeded)、404(session_not_found)、408(session_expired)、413(payload_too_large)、429(rate_limit_exceeded)等,并给出对应修复方式,如用 ffmpeg 转换音频、重新生成密钥、等待 Retry-After 秒数等。

使用方式:前置条件为完成 speak-install-auth 设置、配置有效 API 凭据并安装 ffmpeg。可用 curl 检查 API 密钥有效性,用 ffprobe 检查音频格式(须为 16000Hz、单声道)。技能还给出错误恢复模式示例,对 429 按 Retry-After 退避重试,对音频格式错误提示先转换再重试,对会话过期提示新建会话。

适用场景:Speak API 集成调试、生产环境错误恢复与监控。

限制:资料未提供具体价格、平台支持范围或性能数据;部分错误处理需自行实现,音频须为 WAV 16kHz 单声道,会话 30 分钟过期,音频文件不超过 25MB、时长 0.5 至 60 秒。