常见问题
这里汇总了接入和使用 GetAINode 时最常遇到的问题。如果没有找到答案，请带上 request id 联系支持，参考服务状态与排障。
接入相关
GetAINode 和直接用 OpenAI 有什么区别？
GetAINode 提供 OpenAI 兼容的 /v1 接口。大多数客户端只需要把 base_url 改成 https://getainode.xyz/v1，再填入 GetAINode 的 API Key 即可使用，集中管理额度、分组和调用记录。
需要改代码吗？
通常不需要。只要客户端支持自定义 Base URL，改两处配置即可：
base_url = https://getainode.xyz/v1
api_key = sk-你的APIKey支持哪些接口？
当前面向用户暴露的兼容接口：
| 接口 | 用途 |
|---|---|
GET /v1/models | 获取可用模型 |
POST /v1/responses | Responses API |
POST /v1/chat/completions | Chat Completions API |
POST /v1/messages | Anthropic Messages API |
Claude/Anthropic 客户端怎么填地址？
如果客户端自己会拼接 /v1/messages，把 API 地址填为：
https://getainode.xyz如果客户端要求填写完整 Base URL 或 endpoint，请以它的说明为准，最终请求路径应落到 https://getainode.xyz/v1/messages。
鉴权与 Key
提示 Invalid token 怎么办？
按顺序检查：
Authorization头是否为Bearer sk-...，且没有多余空格。- API Key 是否被禁用或删除。
- Base URL 是否为
https://getainode.xyz/v1。
详见错误处理。
API Key 忘了或丢了怎么办？
API Key 只在创建时完整展示一次，无法找回。请在 API Keys 页面删除旧 Key 并创建新的。参考获取 API Key。
怀疑 Key 泄露了？
立即禁用旧 Key、创建新 Key 并更新客户端，然后检查调用记录是否有异常 IP、模型或用量。更多见安全建议。
计费与额度
提示额度不足（insufficient quota）？
可能是账户余额或单个 API Key 的额度用尽。请在钱包页面补充余额，或在 API Keys 页面调高该 Key 的额度。
为什么这次调用比预期贵？
费用主要由 prompt tokens、completion tokens、模型和分组决定。长上下文、高推理强度会显著增加消耗。控制台的调用记录是最终核对入口，详见计费与额度。
性能与稳定性
响应很慢、首字时间长？
通常和这些因素有关，先排查再增加重试：
- prompt tokens 过大（长对话、长文档）
- 推理强度过高（如 Codex 的
xhigh） - 客户端没有开启流式输出
- 客户端超时设置或网络链路不稳定
经常断流或中断？
检查客户端超时是否过短、是否主动取消了请求，以及网络是否稳定。context canceled 一般意味着客户端先断开了连接。
怎么选模型？
| 场景 | 建议模型 |
|---|---|
| 复杂代码、长上下文 | gpt-5.5 |
| 常规问答、中等任务 | gpt-5.4 |
| 简单任务、快速验证 | gpt-5.4-mini |
| Claude 日常任务 | claude-sonnet-4-6 |
安全与合规
可以在前端直接调用吗？
不建议。前端代码、公开仓库、客户端安装包都会暴露 API Key。生产系统应由后端持有 Key，并对用户请求做二次鉴权和用量控制。
多人/多客户端能共用一个 Key 吗？
不建议。请为每个人、每个客户端单独创建 Key，便于追踪用量和快速止损。参考限流建议。