Gemini Generate Content

POST /v1beta/models/{model}:generateContent —— Google Gemini 兼容接口,支持同步与流式。Google Gen AI SDK 配置基地址即可。

鉴权

Google SDK 默认通过 x-goog-api-key 头发送 key。注意 Gemini 协议的 model 在 URL 路径里,而不是请求体。

同步生成

POST /v1beta/models/{model}:generateContent

Python

from google import genai

client = genai.Client(
    api_key="xsk_...",
    http_options=genai.types.HttpOptions(base_url="https://xingsuan.cloud"),
)

resp = client.models.generate_content(
    model="gemini-2.0-flash",
    contents="用一句话介绍你自己",
)
print(resp.text)

curl

curl "https://xingsuan.cloud/v1beta/models/gemini-2.0-flash:generateContent" \
  -H "x-goog-api-key: $XSK_KEY" \
  -H "content-type: application/json" \
  -d '{ "contents": [{"parts": [{"text": "用一句话介绍你自己"}]}] }'

流式生成

POST /v1beta/models/{model}:streamGenerateContent

是否走 SSE 由 query 参数 alt=sse 决定:加上返回 text/event-stream,不加则返回流式 JSON。网关零转换透传上游格式。

curl "https://xingsuan.cloud/v1beta/models/gemini-2.0-flash:streamGenerateContent?alt=sse" \
  -H "x-goog-api-key: $XSK_KEY" \
  -H "content-type: application/json" \
  -d '{ "contents": [{"parts": [{"text": "讲个短故事"}]}] }'

模型列表

GET /v1beta/models —— 列出当前 Key 可见的 CHAT 类启用模型(VIDEO 类被过滤),返回 Google 标准格式。

错误

错误信封为 Google 形状({"error":{"code":<int>,"message","status":<STATUS>}}),注意 code 是 HTTP 整数,详见 错误码。