Gemini CLI 配置

通过 OpenAI 兼容端点或环境变量，让 Gemini 相关 CLI 工具走启元Hub。

说明

部分 Gemini CLI 工具支持通过 OpenAI 兼容协议接入第三方网关。启元Hub 提供统一 Base URL，可按工具文档配置 API Key 与端点。

环境变量配置

不同 CLI 版本变量名可能不同，请以工具官方文档为准，将端点替换为启元Hub 地址即可。

1. 通用 OpenAI 兼容配置

export OPENAI_API_KEY="sk-opc-your-api-key"
export OPENAI_BASE_URL="https://api.qiyuanapi.cc/v1"

2. 若工具使用 GEMINI_API_KEY

export GEMINI_API_KEY="sk-opc-your-api-key"
export GEMINI_BASE_URL="https://api.qiyuanapi.cc/v1"

验证接入

curl https://api.qiyuanapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.6",
    "messages": [{"role": "user", "content": "测试 Gemini CLI 网关"}]
  }'

使用建议

优先在控制台确认余额充足
流式输出场景建议开启 stream: true
遇到 401 请检查 API Key 是否有效、用户是否已审核通过