#快速开始

本页使用 OpenAI Chat Completions 完成一次最小调用。它兼容范围广，适合先验证服务地址、令牌和模型是否可用；使用 Codex CLI 或 Claude Code CLI 时，请改用对应的专用教程。

#1. 配置永久环境变量

先在 API Keys 页面生成 Geekit 令牌，再将以下内容写入当前用户的 shell 配置文件。Zsh 使用 ~/.zshrc，Bash 使用 ~/.bashrc；macOS 上手动使用 Bash 时通常写入 ~/.bash_profile。

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

保存后重新打开终端，或在当前终端执行对应的加载命令：

# Zsh
source ~/.zshrc

# Bash
source ~/.bashrc

Windows 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_BASE_URL 使用服务根地址，不要在这里重复添加 /v1。GEEKIT_API_KEY 是固定的变量名，它的值必须替换为控制台生成的真实令牌。模型优先选择模型广场当前可用的最新版本；Codex 可从 gpt-5.6-sol 开始，Claude 可从 claude-opus-5 开始。

shell 配置文件会长期保存令牌，只应在个人设备上使用，并限制为当前用户可读写。不要把配置文件或真实令牌提交到项目仓库。

#2. 查询可用模型

curl "$GEEKIT_BASE_URL/v1/models" \
  -H "Authorization: Bearer $GEEKIT_API_KEY"

响应中的 data[].id 是可直接用于请求的模型 ID。如果第一步使用的模型不在列表中，请复制一个真实值，并修改 shell 配置文件中的 GEEKIT_MODEL；PowerShell 用户重新设置用户级变量：

[Environment]::SetEnvironmentVariable("GEEKIT_MODEL", "<Geekit 模型 ID>", "User")

修改后重新打开终端，再继续调用。

列表中出现模型只表示账户当前可见。工具调用、多模态、推理内容和上下文长度仍由模型及其渠道决定。

#3. 发起第一次对话

curl "$GEEKIT_BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $GEEKIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"$GEEKIT_MODEL\",
    \"messages\": [
      {\"role\": \"user\", \"content\": \"请用一句话介绍 Geekit。\"}
    ]
  }"

成功响应通常包含 choices[0].message 和 usage。如果返回 401，先检查令牌是否完整；如果返回模型不可用错误，重新从 /v1/models 复制模型 ID。

#4. 开启流式响应

在同一请求中加入 "stream": true：

curl -N "$GEEKIT_BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $GEEKIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"$GEEKIT_MODEL\",
    \"messages\": [
      {\"role\": \"user\", \"content\": \"列出三种适合流式输出的场景。\"}
    ],
    \"stream\": true
  }"

-N 会关闭 curl 的输出缓冲。终端应持续收到以 data: 开头的 SSE 事件，直到完成标记。如果普通请求成功但流式请求长时间无输出，请参阅流式响应与错误。

#5. 查看调用日志

请求结束后，在 Geekit 控制台打开调用日志，按时间确认刚才的记录。重点核对：

• 请求状态与 HTTP 状态码。
• 使用的令牌、模型和接口类型。
• 输入、输出、缓存或推理 Token。
• 预扣与最终结算额度。
• 请求 ID 和脱敏后的错误信息。

日志中没有记录通常表示请求未到达 Geekit，例如服务地址写错、DNS 失败或客户端在本地拦截。

#下一步

• 首选命令行 Agent：Codex CLI / Claude Code CLI。
• 查找协议与参数：API 参考。
• 选择适合客户端的接口：模型与协议。
• 排查鉴权、限流和上游错误：流式响应与错误。