跳轉到主要內容
POST
/
v1beta
/
models
/
{model}
:generateContent
curl -X POST "https://api.lemondata.cc/v1beta/models/gemini-2.5-pro:generateContent?key=sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [{"text": "Hello, Gemini!"}]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 1024
    }
  }'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {"text": "Hello! How can I assist you today?"}
        ]
      },
      "finishReason": "STOP",
      "safetyRatings": [
        {"category": "HARM_CATEGORY_HARASSMENT", "probability": "NEGLIGIBLE"}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 5,
    "candidatesTokenCount": 10,
    "totalTokenCount": 15
  }
}
LemonData 支援 Gemini 模型的原生 Google Gemini API 格式。這使得與 Google AI SDK 具有直接的相容性。

​
路徑參數

​
model
string
必填
模型名稱（例如：gemini-2.5-pro、gemini-2.5-flash）。

​
查詢參數

​
key
string
API key（標頭驗證的替代方案）。

​
驗證

Gemini 端點支援多種驗證方式：
  • ?key=YOUR_API_KEY 查詢參數
  • x-goog-api-key: YOUR_API_KEY 標頭
  • Authorization: Bearer YOUR_API_KEY 標頭

​
請求主體

​
contents
array
必填
對話內容。每個內容物件包含：
  • role (string)：user 或 model
  • parts (array)：內容部分（文字或內嵌數據）
​
systemInstruction
object
模型的系統指令。
​
generationConfig
object
生成配置：
  • temperature (number)：取樣溫度
  • topP (number)：核取樣機率
  • topK (integer)：Top-K 取樣
  • maxOutputTokens (integer)：最大輸出 token 數
  • stopSequences (array)：停止序列
​
safetySettings
array
安全過濾器設定。

​
回應

​
candidates
array
生成的內容候選。
​
usageMetadata
object
Token 使用資訊。
curl -X POST "https://api.lemondata.cc/v1beta/models/gemini-2.5-pro:generateContent?key=sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [{"text": "Hello, Gemini!"}]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 1024
    }
  }'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {"text": "Hello! How can I assist you today?"}
        ]
      },
      "finishReason": "STOP",
      "safetyRatings": [
        {"category": "HARM_CATEGORY_HARASSMENT", "probability": "NEGLIGIBLE"}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 5,
    "candidatesTokenCount": 10,
    "totalTokenCount": 15
  }
}