运维指南
Sakana Fugu 故障排查要先写出下一步检查
“API 失败了”不是诊断。这一页把官方的访问、模型、地区和计费规则收成一份短清单，让你在重试昂贵的 Ultra 或 Cyber 请求之前，先把配置问题排除掉。
1. 先分清是谁的问题
第一次失败多半是本地问题：缺环境变量、base URL 没有 /v1、钥匙的计费模式不对，或当前钥匙看不见这个模型 ID。对 fugu-ultra 盲目重试，可能重复编排工作。配置不完整时，应在启动阶段失败。
| 看到 | 先查 | 不要做 |
|---|---|---|
| 401 或 403 | 钥匙存在、有效，且计费模式正确 | 把密钥打进日志 |
| 找不到模型 | 用同一把钥匙和 base URL 调 GET /v1/models | 偷偷换成另一个模型 |
| 欧盟/EEA 用户连不上 | 官方可用性，而不是超时 | 绕过已公布的地区限制 |
| 列表里没有 Cyber | 准入是否批准，以及是否按量计费 | 以为旧单价表还能打开接口 |
| 账单高于可见回答 | 编排字段和 272K 阈值 | 只按输出长度估费用 |
2. 认证通过不等于 Cyber 已开通
一把能调 fugu 的钥匙仍可能在 fugu-cyber 上失败。官方 Models 写明：Cyber 只在按量计费下返回，并且要提交用途和可核验联系方式的准入申请。成功调用 Fugu 之后出现的 403，和缺少 FUGU_API_KEY 不是同一类问题。
分开确认三件事：进程读得到钥匙和 base URL；计费模式是你想要的（Cyber 必须按量）；Cyber 申请已被批准。详见 Cyber 准入指南。
3. 记下你真正调用的标识
2026 年 8 月 17 日的 Models 页列出稳定 ID 和带版本的 ID。fugu-ultra 目前默认 fugu-ultra-v1.1；fugu-ultra-v1.0 即原来的 fugu-ultra-20260615；fugu-cyber 默认 fugu-cyber-v1.0。两个环境不一致时，对比 Models API 的返回，而不是 README 里的字符串。
4. 把欧盟/EEA 不可用当成产品规则
官方产品页写明：在完成 GDPR 与欧盟相关合规之前，Sakana Fugu 尚未在欧盟/EEA 提供。FAQ 也写不向成员国提供服务。这不是加大超时就能修好的客户端问题。生产用户在这些地区时，选择器会返回不可用。
5. 费用异常通常来自被丢掉的字段
官方定价说明：Ultra 会在普通 input/output 之外报告编排用量，而且这些字段是真实计费。只存 input_tokens 和 output_tokens 的日志，会低估多智能体请求。272K 是单次上下文阈值，不是月用量；Ultra 的 max_output_tokens 只限制最终模型，不是总花费上限。用 编排 token 指南 或 Ultra 计算器 核算，不要编 Fugu 均价或已撤回的 Cyber 单价。
还有一类“看起来成功、产品却不对”的失败：temperature 或 top_p 没效果，是因为官方写明这些字段会被忽略；previous_response_id 被拒绝，就要把历史放进 input；看不到哪个工人回答了问题，是因为官方 FAQ 说路由专有。这些都不该用更大超时去修。把模型 ID、prompt、工具和完整 usage 存下来，再用 评估手册 打分，比同题连打三次更接近原因。
排查顺序建议固定：先确认钥匙和 base URL，再查 Models API 里有没有这个 ID，再查地区和 Cyber 准入，最后才看账单字段。跳过前几步直接重试 Ultra，最容易把一次配置错误变成两次编排费用。需要复制可运行示例时回到 API 快速开始。不要把同一失败请求自动循环提交。
本页不覆盖什么
这里不诊断 Sakana AI 控制台宕机，也不猜测未公开的错误码。产品侧故障应走官方支持。本页只处理文档已经写明的边界：钥匙、模型列表、地区、Cyber 准入和账单字段。超出这些边界的现象，先保存请求 ID 再问官方，不要在本站评论区求“万能重试参数”。