Gemini 協定

使用 Gemini generateContent 格式傳送內容。

服務位址

本頁涵蓋 Gemini 原生 REST 的模型清單、內容生成、串流生成和嵌入介面。Gemini 圖像參數請查看圖片與影片生成中的 Gemini 原生圖片指南。

模型與探索

用途	方法	路徑
Gemini 模型清單	GET	/v1beta/models
Gemini 相容模型清單	GET	/v1/models

內容生成

用途	方法	路徑
generateContent	POST	/v1beta/models/{model}:generateContent
streamGenerateContent	POST	/v1beta/models/{model}:streamGenerateContent

嵌入

用途	方法	路徑
embedContent	POST	/v1beta/models/{model}:embedContent
batchEmbedContents	POST	/v1beta/models/{model}:batchEmbedContents
Gemini 相容嵌入	POST	/v1/engines/{model}/embeddings

最小請求

將 YOUR_MODEL 替換為實際模型 ID，並放在 URL 路徑中。建議使用 x-goog-api-key: YOUR_API_KEY；閘道也相容 Bearer，只有用戶端明確要求時才使用查詢參數 key，避免 Key 出現在記錄和歷史中。

curl "https://api.popgo.site/v1beta/models/YOUR_MODEL:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"parts": [{"text": "請回覆連線成功"}]}
    ]
  }'

驗證

成功回應包含候選內容或嵌入結果。串流請求使用 streamGenerateContent；嵌入請求依用戶端選擇 embedContent、batchEmbedContents 或相容路徑。出現 404 時檢查模型 ID、協定路徑和 Key 分組。