#API 参考

Geekit 使用一套服务地址和用户令牌承接多种主流 AI 协议。客户端选择与模型匹配的协议后，请求会由 Geekit 完成鉴权、路由、用量记录和额度结算。

#第一步：配置永久环境变量

先在 API Keys 页面生成令牌，再将以下内容写入 ~/.zshrc（Zsh）或 ~/.bashrc（Bash）：

export GEEKIT_BASE_URL="https://geekit.yryq.top"
export GEEKIT_API_KEY="<生成的真实 Geekit 令牌>"
export GEEKIT_MODEL="<Geekit 模型 ID>"

保存后重新打开终端，或执行 source ~/.zshrc / source ~/.bashrc。PowerShell 使用用户级永久环境变量：

[Environment]::SetEnvironmentVariable("GEEKIT_BASE_URL", "https://geekit.yryq.top", "User")
[Environment]::SetEnvironmentVariable("GEEKIT_API_KEY", "<生成的真实 Geekit 令牌>", "User")
[Environment]::SetEnvironmentVariable("GEEKIT_MODEL", "<Geekit 模型 ID>", "User")

设置后关闭并重新打开 PowerShell。GEEKIT_API_KEY 是固定的变量名，变量值替换为控制台生成的真实令牌。模型优先选择模型广场当前可用的最新版本；Codex 推荐 gpt-5.6-sol，Claude 推荐 claude-opus-5。通用 OpenAI 兼容客户端通常填写 https://geekit.yryq.top/v1；Claude Code 使用服务根地址；要求完整请求 URL 的客户端则填写具体路径。

#鉴权

推荐使用 Bearer Token：

Authorization: Bearer <生成的真实 Geekit 令牌>

Anthropic Messages 客户端也可以使用：

x-api-key: <生成的真实 Geekit 令牌>
anthropic-version: 2023-06-01

Gemini 客户端可使用 x-goog-api-key 或 ?key=，但本文示例仍优先使用 Bearer，便于在不同协议间保持一致。

#接口选择

客户端只支持 Chat Completions 时不要强行配置 Responses；模型只支持某一种协议时，也不要依赖网关转换获得完整的工具、推理或多模态能力。具体选择方法见模型与协议。

#通用请求规则

• model 必须使用控制台或模型列表返回的精确 ID。
• JSON 请求需发送 Content-Type: application/json；文件上传接口通常使用 multipart/form-data。
• 可选参数是否生效取决于模型与上游渠道。不要假设温度、工具调用、结构化输出或推理参数在所有模型上等价。
• 流式 HTTP 接口使用 SSE；Realtime 使用 WebSocket。
• 请求成功后仍应查看 usage 和 Geekit 调用日志，确认实际 Token 与结算结果。

#错误响应

先根据 HTTP 状态码定位问题：

错误体会尽量保留所用协议的兼容结构。排查时记录请求时间、路径、模型、HTTP 状态码和请求 ID，不要公开令牌或包含私密数据的完整请求体。

#接口范围

本站的 API 参考 只说明经过核对的用户调用端点。现有机器可读规范还包含未开放路径和管理域模型，因此不在公开站下载；用户与渠道管理接口同样不属于公开文档范围。