Fish Audio 的官方入口是 fish.audio，注册登录后在账户后台的 API Keys 页面点击「Create New Key」，密钥即生成，完整 Key 只会展示一次。API 基址为 api.fish.audio，采用 Bearer Token 鉴权、按 UTF-8 字节计费，当前主力模型是 S2 Pro 与 S1，单价 $15 / 100 万 UTF-8 字节。下面按入口、创建步骤、模型价格、计费规则、报错排查逐项说明。 Fish Audio API Key 的官方入口在哪
先解决一个比找 Key 更麻烦的问题：网络上挂着「Fish Audio」名字、看起来同样像官方站点的域名不止一个，进错门比拿不到 Key 更伤。下面三个入口指向同一套官方体系：
- 官方网站：fish.audio注册账号、创建和管理 API Key、查看余额都在这里。GitHub 上官方组织 fishaudio 的站点字段指向的正是该域名，开源仓库 fish-speech 的主页也是 speech.fish.audio。
- 开发者文档：docs.fish.audio。含快速开始、认证、语音合成、API Playground 等页面，动笔写代码前先读这一份。
- API 基址：api.fish.audio。语音合成端点为 https://api.fish.audio/v1/tts。
两类账号体系的区别：fish.audio 网页版是给普通用户用的可视化创作工具，注册即送额度，点着就能用；API 面向开发者，按量付费、不需要先买会员。API Key 与网页版额度是否互通，官方文档未统一说明，以控制台 Billing 页面显示为准。
密钥创建流程与安全保存要点
从零到一个能用的 Key，官方文档给出的路径是 5 步：
- 打开 fish.audio，在 fish.audio/auth/signup 注册账号，完成邮箱验证并登录；
- 登录后进入账户后台，找到 API Keys 区域；
- 点击 Create New Key，起一个能一眼认出的名字（比如"口播脚本专用"），需要的话顺手设置有效期；
- 立刻复制并存好——完整 Key 只显示这一次，弹窗一关就永远看不到，丢了只能删掉重建。
- 把 Key 写进服务端环境变量（官方示例用 FISH_API_KEY），不要留在前端代码里。
两个前置条件值得提前知道。Key 本身只是身份凭证，账户余额为零时调用会直接返回 402，得先去 Billing 页面充值；官方还要求不要把 Key 放进浏览器 JavaScript、移动端应用、公开仓库、日志或用户可见的报错信息，按"生产账号的密码"对待。同时，官方提供 Python 与 JavaScript 两套 SDK，安装命令分别是 pip install fish-audio-sdk 和 npm install fish-audio，不想手搓 HTTP 请求可以直接用。
拿到 Key 后，最小可跑的验证请求是往 https://api.fish.audio/v1/tts 发一个 POST，请求头带上 Authorization: Bearer 加你的 Key，并把 model 指定为 s2-pro（官方文档示例即如此），请求体里给出 text 与 format 两个字段即可。
Speech 模型与 API 价格一览
截至本文核查时间（2026 年 9 月 10 日），Fish Audio 公开的语音模型与单价如下：
| | | |
|---|
| 当前主力模型，主打表现力与多说话人对话，文档快速开始示例所用模型 | | |
| | | |
| | | |
| | | |
第三方模型网关 OpenRouter 上挂出的 fish-audio/s2-pro 同样标价 $15 / 100 万 UTF-8 字节，可与官方定价页互相印证。真正决定账单的是字节而不是"字符"：1 个英文字母或数字约占 1 字节，1 个汉字约占 3 字节。官方口径是 100 万 UTF-8 字节约等于 18 万英文单词、约 12 小时英文语音，折算约 $1.25 / 小时；换成中文，同样 100 万"字符"要多掏约 3 倍的钱，约 $45。 会员套餐与 API 是两套账，额度口径如下（价格为促销后的量级参考）：
需要提醒的是，有第三方评测指出官方曾在 2026 年 8 月 31 日前执行周年促销价，活动结束后已回调，所以上表的会员价格只能当量级参考，下单前请以 fish.audio 定价页实时显示为准。credits 与音频时长的换算大致是每分钟消耗 600–625 credits。
计费规则与免费额度说明
API 采用纯按量付费，不强制订阅会员，用多少扣多少。账户里通常存在"充值余额"和"订阅赠送 credits"两类额度，两者能否叠加、扣减优先级如何，官方文档没有统一交代，实际以控制台 Billing 页面显示为准。
关于免费：网页端注册赠送 8,000 credits（约 7 分钟），单次生成上限 500 字符，只够尝个味。API 侧是否有新账号赠送额度，官方文档未明确披露。截至目前，未查到 API 端固定的免费额度说明，建议注册后先到 Billing 页面确认余额再调用。
还有两个容易踩的坑。一是并发限制：有第三方梳理称，预付费累计不足 $100 的账号并发上限为 5，超过 $100 提升到 15，超过 $1,000 为 50，企业级可单独协商；该分级来自第三方整理而非官方文档，正式投放前建议向官方确认。二是商用授权：据第三方评测 ToolJunction 对官方页面的对比，定价页曾把"commercial use"列为免费套餐权益，而服务条款又写明未付费用户只能将生成内容用于个人与非商业用途，两处口径存在冲突。涉及商单、广告或付费产品时，建议使用付费套餐，或先取得官方书面确认。
常见报错与排查速查表
鉴权失败会在请求到达 API 层时返回 JSON 错误，官方文档列出的高频状态码如下：
| | |
|---|
| 请求参数有误，例如 reference_id / 音色 ID 不存在 | |
| | |
| | |
| | |
排查时记得记录响应里返回的 requestId。官方支持靠它定位具体请求，有了它你就不用把 Key 或原始报文交出去。
使用与安全注意事项
- 认准域名：官方主站是 fish.audio，文档是 docs.fish.audio。另有一个名为 fishaudio.org 的站点，其"关于"页面自称由上海奇塔灵动科技有限公司（KITTA AI）运营，把 Fish Audio 与 MiniMax、Qwen 等模型聚合在同一工作台，并有独立的中文文档与定价体系，会员价格与主站不一致。该站点是否为官方授权渠道，本文未能核实，付费前请自行确认运营主体与授权关系。
- Key 只显示一次：创建后立即保存，关闭弹窗无法再次查看，只能删除重建。
- 不要把 Key 放前端：浏览器 JS、移动端包体、公开仓库、日志、错误提示里都不行，一律放在服务端环境变量或密钥管理服务中。
- 定期轮换：团队成员离职、构建日志可能泄露密钥、或从测试切到生产环境时，都应重新生成 Key，先部署新 Key 并验证流量，再吊销旧的。
- 商用前确认授权：免费额度的商用范围在官方定价页与条款之间存在口径差异，正式商用建议升到付费套餐。
Fish Audio API Key 常见问题
Q：Fish Audio API Key 是免费的吗？
A：Key 本身免费，注册即可创建，但调用按量计费；账户余额为零时请求会返回 402，需要先充值。
Q：有没有直达创建密钥页面的短链接？
A：官方文档只给出"登录后台 → 进入 API Keys → 点击 Create New Key"的路径，未公布固定的直达地址，建议从 fish.audio 首页进入，避免误点仿冒站。
Q：支持哪些音频输出格式？
A：官方文档示例使用 mp3，社区与第三方资料提到还支持 wav、pcm、opus；具体可选项以接口请求参数说明为准。
Q：调用返回 401 或 402 怎么解决？
A：401 检查 Key 是否完整、是否已被吊销或账号是否正常；402 是余额不足，去 Billing 页面充值即可。
Q：注册需要实名或企业资质吗？
A：官方快速开始只要求注册账号并完成邮箱验证，未提及实名或企业资质要求；企业级定制与更高并发才需要走商务联系。
Q：有调用频率或并发上限吗？
A：存在并发分级，据第三方整理按预付费金额分为 5 / 15 / 50 三档，官方文档未集中列出，正式投放前建议向官方确认。
Q：Key 不小心泄露了怎么办？
A：立即在后台吊销并新建 Key，然后先部署新 Key 验证流量，再确认旧 Key 已失效；同时排查日志与仓库历史。
Q：中文和英文的价格一样吗？
A：单价相同，但计费按 UTF-8 字节。英文 1 字符约 1 字节，汉字约 3 字节，所以同样"字数"的中文内容成本约为英文的 3 倍。
Q：只想先试用，怎么最省钱？
A：先用网页端免费额度（8,000 credits，单次上限 500 字符）测音色和效果，确认可用后再充值 API，并按分钟数估算 credits 消耗，避免一次性充太多。
以上内容仅供参考，模型版本、价格与计费政策可能随官方更新而变动，请以 Fish Audio 官方文档与定价页最新公布为准。
AI 速览
