顶级AI顶级AI
工具接入教程

Gemini 接入

Gemini native 工具使用 x-goog-api-key 访问顶级AI的注意事项。

不要把 Key 放进 URL

Gemini 原生入口支持 x-goog-api-key header。顶级AI 默认不接受 ?key= query key,避免密钥出现在浏览器地址栏、日志或分享链接里。

工具里怎么填

  • Base URL:填写 https://dingjiai.com
  • API Key:填写顶级AI用户 API Key。
  • Model:从 /v1beta/models 复制 Gemini native 可用模型。

查看 Gemini 模型目录

GET /v1beta/models
curl https://dingjiai.com/v1beta/models \
  -H "x-goog-api-key: YOUR_USER_API_KEY"

发送 generateContent 请求

POST /v1beta/models/{model}:generateContent
curl https://dingjiai.com/v1beta/models/MODEL_NAME:generateContent \
  -H "x-goog-api-key: YOUR_USER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [
          { "text": "用一句话解释 API Key" }
        ]
      }
    ]
  }'

常见坑

  • 如果返回 api_key_query_unsupported,说明工具把 Key 放到了 URL query。请改成 header 方式。
  • OpenAI-compatible 模型目录和 Gemini native 模型目录不是同一个入口。
  • 如果工具只支持官方 Gemini URL 且不能改 header,暂时不适合直接接入。