Skip to content

Gemini 接口 ​

调用 Gemini 原生接口时,请求 POST https://api.niceai.dev/v1beta/models/<模型名>:generateContent,用 x-goog-api-key 请求头传 NiceAI 密钥(分组选 Gemini)。使用 Google 官方 SDK 时,Base URL 只填 https://api.niceai.dev,SDK 会自己拼上 /v1beta。

请求示例 ​

bash
curl "https://api.niceai.dev/v1beta/models/<模型名>:generateContent" \
  -H "x-goog-api-key: $NICEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "用一句话解释什么是 token"}]}]
  }'
python
import os
from google import genai
from google.genai import types

client = genai.Client(
    api_key=os.environ["NICEAI_API_KEY"],
    http_options=types.HttpOptions(base_url="https://api.niceai.dev"),
)
resp = client.models.generate_content(model="<模型名>", contents="用一句话解释什么是 token")
print(resp.text)

流式输出 ​

把路径里的 generateContent 换成 streamGenerateContent,并加上 ?alt=sse,返回就会变成 SSE 事件流:

bash
curl -N "https://api.niceai.dev/v1beta/models/<模型名>:streamGenerateContent?alt=sse" \
  -H "x-goog-api-key: $NICEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents": [{"parts": [{"text": "写一首四行短诗"}]}]}'

请求体要点 ​

字段说明
contents对话内容,每条包含 role(user / model)和 parts
systemInstruction系统提示词,格式为 {"parts": [{"text": "..."}]}
generationConfig生成参数,例如 temperature、maxOutputTokens
tools函数声明(functionDeclarations),需模型支持

地址写法对照 ​

场景填写
直接发 REST 请求https://api.niceai.dev/v1beta/models/<模型名>:generateContent
google-genai SDKbase_url="https://api.niceai.dev"
Gemini CLIGOOGLE_GEMINI_BASE_URL=https://api.niceai.dev,见 Gemini CLI 接入

常见问题 ​

返回 404? ​

检查路径中是否带了 /v1beta,以及模型名后面的冒号和方法名(:generateContent)是否完整。

返回 401 或 403? ​

确认密钥分组为 Gemini,并通过 x-goog-api-key 请求头传递。

下一步 ​

NiceAI · 稳定的 AI 大模型 API 中转站