#常见问题

#地址与鉴权

#返回 401

确认客户端使用的是 Geekit 用户令牌，而不是上游服务商密钥。检查令牌是否过期、停用或包含前后空格；排查时只验证变量是否存在，不要打印真实值。

#返回 403

当前令牌可能没有模型权限、额度不足，或触发了访问限制。先查看个人控制台中的令牌状态和错误日志；需要调整权限时联系服务管理员。

#返回 404

最常见原因是 Base URL 与协议不匹配：

• Chat 与 Responses 通常使用 https://geekit.yryq.top/v1。
• Claude Code 的 ANTHROPIC_BASE_URL 使用 https://geekit.yryq.top。
• 填写完整端点的客户端不要再让它自动拼接路径。

检查实际请求是否出现 /v1/v1、重复端点或漏掉 /v1。

#模型与协议

#客户端提示模型不存在

调用 /v1/models，复制当前令牌真实可见的模型 ID。不要照搬客户端内置名称，也不要假设不同令牌拥有相同模型列表。

#文本能回复，但工具调用失败

连接和模型能力是两件事。确认模型原生支持当前协议下的工具调用，并用一个简单工具任务复测。只支持 Chat 的模型不一定能完整支持 Responses Agent 流程。

#Codex CLI 请求到了错误端点

Codex 自定义 Provider 应设置 wire_api = "responses"，Base URL 填到 /v1。详见 Codex CLI。

#Claude Code 返回协议错误

Claude Code 使用 Anthropic Messages。ANTHROPIC_BASE_URL 填 Geekit 根地址，不要追加 /v1/messages；客户端会自行拼接端点。

#流式响应

#输出中途停止或一直不结束

先用非流式最小请求判断模型和鉴权是否正常，再测试流式请求。若只有流式失败，记录发生时间、请求 ID、客户端版本和端点，提交给服务支持方。

#返回了事件文本而不是正常内容

客户端可能没有按所选协议解析事件流，或模型返回格式与客户端预期不一致。核对客户端 Provider 类型，不要把 Responses、Chat 和 Messages 混用。

#额度与日志

#额度扣减和预期不一致

打开对应调用日志，先核对模型、输入、输出、缓存命中、推理 Token 和最终扣费。不同模型和请求类型的计费口径可能不同，详见计费与日志。

#请求失败后是否会扣费

以最终调用日志和余额变化为准。失败请求可能在开始时预留额度，结算时会按实际结果处理差额；若状态长时间没有完成结算，记录请求 ID 联系支持。

#日志里找不到请求

确认客户端实际请求的是当前 Geekit 地址，并按请求时间、令牌和模型筛选。完全没有日志通常表示请求未到达 Geekit，例如 DNS、网络、代理或客户端地址配置错误。

#仍未解决

按社区交流准备最小复现信息。不要提交令牌、请求正文中的敏感数据或未经脱敏的完整日志。