[ FAQ ]
常见问题
接入、计费、账户相关的常见说明。更细的协议与报错处理见 API 文档。
产品与计费
一个入口调用所有 AI 能力。一个 Key、一张账单，路由层负责分发与计量。
完全兼容。只改 Base URL，支持 Codex、Claude Code 及任意 OpenAI 协议客户端。
企业级用量承接 + 多通道实时比价，差价直接让给你。
不会。仅用于路由、计量与计费，绝不训练、绝不出售。
不会。无订阅、无月费、无最低消费。
模型按 Token 计费，MCP 按次计费，价格以定价页与能力详情为准。Skill 免费安装到本地，不在平台运行，也不计入消费。组合包是安装清单，本身不计费。
手机号登录后进入控制台，创建 API Key，将客户端的 Base URL 指向 FlyHub，即可按量调用。具体步骤见 API 文档。
接入与调用
登录控制台，在「密钥」中创建。模型与 MCP 共用同一把 Key。请用环境变量或密钥管理服务保存，不要写入前端或提交到 Git。
OpenAI 兼容（Chat Completions / Responses）、Anthropic Messages、Google Gemini 原生协议，以及平台 MCP 调用。Claude 模型请优先用 Anthropic 原生协议，以免丢失提示缓存、thinking 等能力。
核对协议与请求头：Anthropic 使用 x-api-key，OpenAI / Gemini 使用 Authorization: Bearer。确认 Key 完整、无多余空格，且未被删除。OpenAI SDK 的 base_url 需带 /v1，Anthropic SDK 则不需要。
调用 GET /v1/models 获取实时列表，核对模型 ID 拼写（小写、连字符），并确认端点与模型协议匹配。定价页与模型广场也可查看当前可售能力。
大型推理模型首 token 可能需要数秒到数十秒，不代表失败。生产环境建议开启 stream: true，并适当增大客户端读取超时。网关支持最长 600 秒响应。
Skill 以安装包交付到本地，不在 FlyHub 上运行。按文档把包装进 Cursor、Claude Code 等客户端即可。
账户与安全
登录控制台打开钱包即可充值。账户余额用于模型和 MCP 调用；余额不足时请求会被拒绝。需要发票或对公转账，请联系 support@flyhub.cn。
立即在控制台删除该 Key 并新建。删除后旧 Key 立刻失效。不要把 Key 硬编码进仓库、演示页或公开客户端。
发邮件到 support@flyhub.cn，尽量附上时间、模型或 MCP 名称、请求 ID（如有）和报错原文。