Gemini 原生
直接使用 Google Gemini 的原生协议。如果您已有基于官方 Gemini SDK 的代码，只需把请求地址指向网关即可。您也可以通过 OpenAI 兼容的 Chat Completions 端点调用 Gemini 模型。
POST
https://apicdn.xyc.ai/v1beta/models/{model}:generateContent
鉴权请求头不同
Gemini 原生协议使用 x-goog-api-key 请求头，或 URL 查询参数 ?key=sk-xxxxxxxx 进行鉴权。
请求示例
curl "https://apicdn.xyc.ai/v1beta/models/gemini-3-pro-preview:generateContent" \
-H "x-goog-api-key: sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{"parts": [{"text": "Introduce yourself in one sentence."}]}
]
}'流式输出
使用 :streamGenerateContent 操作获取流式输出：
https://apicdn.xyc.ai/v1beta/models/gemini-3-pro-preview:streamGenerateContent可用模型
原生协议下常用的 Gemini 模型名称：gemini-3.1-pro-preview、gemini-3-pro-preview、gemini-3-flash-preview、gemini-2.5-pro、gemini-2.5-flash。完整列表见模型列表。
响应结构
{
"candidates": [
{
"content": {"parts": [{"text": "..."}], "role": "model"},
"finishReason": "STOP"
}
],
"usageMetadata": {"promptTokenCount": 8, "candidatesTokenCount": 20}
}