API 文档
API Key 认证
创建 Fish Audio API Key，使用 Bearer 令牌认证 Open API 请求，并在 API Playground 中验证配置。
认证
Fish Audio Open API 使用 Bearer API Key。API Key 用于识别账户、权限和 API 额度。
Authorization: Bearer FISHAUDIO_API_KEY在账户设置中创建 API Key，再到在线调试页验证接入：
请求要求
每个 Open API 请求都必须携带 Authorization。JSON 请求还需发送 Content-Type: application/json。
curl https://fishaudio.org/api/open/v1/profile \
-H "Authorization: Bearer FISHAUDIO_API_KEY"API Key 只能保存在服务端密钥管理器或加密环境变量中。不要将其放入浏览器代码、移动端应用、公开仓库、日志、分析事件或面向客户的错误信息。
如果密钥可能泄露、成员离职或环境切换，应创建新密钥、部署并验证新配置，然后撤销旧密钥。
错误处理
| 状态码 | 含义 | 建议 |
|---|---|---|
401 | API Key 缺失、无效、已撤销或账户不可用 | 停止重试并更新密钥 |
402 | API 额度不足 | 提示充值或缩小批次 |
429 | 请求受到限流 | 使用退避重试；异步任务继续查询原任务 ID |
请记录错误响应中的 requestId，便于支持人员定位请求。认证本身不消耗积分，但通过认证的媒体接口可能预扣或消耗 API 额度。