API 文档
认证
使用 API Key 认证 Fish Audio Open API 请求。
认证
Fish Audio Open API 使用 Bearer API Key。API Key 用于识别账户、权限和 API 额度。
Authorization: Bearer FISHAUDIO_API_KEY可在账户设置中创建和管理 API Key：
https://fishaudio.org/zh/account?section=api请求要求
每个 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 额度。