常见问题

汇总 PilotAIHub 使用过程中最常见的疑问，按主题分类便于快速检索。

账号与 Key

PilotAIHub 是面向开发团队的托管式多模型 API 服务与虚拟 Key 治理平台。平台聚合了通义千问、Moonshot、智谱、百川等主流大模型服务商，通过统一的 OpenAI 兼容网关对外提供服务。详见平台介绍。

注册账号后，进入控制台 → 项目 → API Key 页面，点击「创建 Key」即可签发虚拟 Key。 Key 明文仅在创建时显示一次，请妥善保存。完整流程见快速入门。

完全兼容。只需将原有 OpenAI SDK 的 base_url 指向 PilotAIHub 网关地址，api_key 替换为 PilotAIHub 虚拟 Key 即可，业务代码无需改动。各类客户端的配置方式见接入 agent 文档。

按 token 用量计费，价格与官方同步并在控制台透明展示。每次调用的计费明细（输入 token、输出 token、缓存命中、成本快照）均写入调用日志，可在控制台「日志」与「账单」页面查询。模型市场页可对比各模型价格，无隐藏费用。

在控制台「项目」页面为每个项目配置月度预算，超限将自动阻断调用。同时可在 API Key 级别设置 RPM/TPM 限流、并发上限、模型范围与 IP 白名单。限流在网关边缘执行，不缓冲 SSE 流式响应。详见 API 调用速率限制说明。

Key 明文不会落库。PilotAIHub 使用 AES-256-GCM 对称加密存储 Key 密文，列表中仅展示脱敏前缀与后缀（如 pk-xxxx…abcd），明文仅在创建时返回一次。复制明文需二次确认并写入审计日志。

已覆盖 11 款主流开发工具：Cursor、Claude Code、Codex、VSCode + Cline、Cherry Studio、 CC Switch、OpenClaw、OpenCode、Gemini CL、WorkBuddy、Trae。配置方式见左侧导航「接入 agent」分组下各文档。

在控制台「日志」页面按 request_id / trace_id 查询调用详情，可查看状态码、错误信息、路由决策、fallback 链路与服务商原始返回。若确认是平台问题，请记录 trace_id 并通过联系我们提交工单，附上 trace_id 可显著加速定位。

没有找到答案？

如果以上内容未能解决您的问题，欢迎通过联系我们页面提供的渠道与团队取得联系，我们会在工作时间内尽快回复。