curl 调试 Gemini API：参数、错误码与排错手册

## 平台介绍 智枢 ZhiShu（api.itzyk.top）是一个面向开发者的 AI API 网关（AI API Gateway），核心目标是用「一个 OpenAI 兼容接口」解决「接入多家大模型」的成本与复杂度。开发者只需替换 Base URL 并填入一枚 API Key，即可用官方或社区的 OpenAI SDK 直接调用 Gemini、DeepSeek、GLM 等系列模型，无需为每家供应商单独写适配、单独管理密钥、单独对账。 与「转售 Key / 简单中转」不同，智枢基于自研的 Go/Gin Gateway 构建，把 Provider、模型、价格、计费、限流、风控都做成可在管理端动态配置的能力：管理员可在后台实时增删上游 Provider、调整模型上下架与成本/售价、查看 Token 级的成本、收入与利润核算，无需重新发版。 平台同时提供完整的开发者与运营闭环：多租户 API Key 与权限管控、按请求/按天的用量统计与趋势排行、余额钱包与支付宝充值、IP 黑名单 / Key 白名单 / 异常行为临时封禁等风控能力、Provider 健康探测与多源故障切换，以及一个可在浏览器里直接试跑模型的 AI Playground。 ## 与主流 API 网关的差异 ① 计费与利润核算到 Token 级：多数第三方网关只记录用量，智枢对每个请求同时记录 Token 数、上游成本、售卖价格与利润，管理员能看到模型/Provider/用户三个维度的成本与毛利排行，便于真实核算经营。 ② 配置即生效：Provider、模型、价格、限流、风控均可在管理后台动态调整并即时生效，而不是硬编码或重启服务；同一份代码可切换任意国内外大模型供应商。 ③ 面向国内开发者场景的完整闭环：内置支付宝在线充值、余额钱包与透支预警、短信通知、工单系统，以及管理端 + 用户控制台 + Playground 的三端体验，贴近国内团队的运营习惯。 ④ 统一 OpenAI 兼容协议：调用侧零学习成本，Python/Node.js/Go/cURL 示例开箱即用，迁移已有 OpenAI 代码只需改一个 base_url。 ## 常见问题 ### 智枢是什么？ 智枢 ZhiShu 是面向开发者的 AI API 网关，提供 Gemini、DeepSeek、GLM 等模型的统一接入。 ### 是否兼容 OpenAI API？ 提供 OpenAI 兼容 API，可用标准 OpenAI SDK 或 HTTP API 接入。 相关页面：[API 服务]