Gemini 內容生成

POST /v1beta/models/{model}:generateContent

身分驗證

將 NeonAPI 金鑰放入 Authorization: Bearer YOUR_API_KEY 請求標頭，在可信應用環境中保管金鑰。

可用性與相容性

呼叫前核對模型的協定、權限、報價與支援參數。不支援的參數可能被拒絕。範例中的金鑰與模型均為佔位符。

路徑與查詢參數

欄位	In	類型	必填
`model`	`path`	`string`	是

請求參數

application/json

欄位	類型	必填	限制	意義
`contents`	`object[]`	是	—	包含 parts 的 Gemini 內容輪次。
`generationConfig`	`object`	是	—	Gemini 生成與模態設定。

完整欄位定義、巢狀物件和引用結構可在下載的規格中查看。

請求範例

export NEON_API_KEY="YOUR_API_KEY"
curl https://neon-api.com/v1beta/models/YOUR_MODEL_ID:generateContent \
  -H "Authorization: Bearer $NEON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Draw a constellation"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ]
  }
}'

回應說明

實際欄位因模型與協定而異。下方結構描述文件中的成功回應；串流請求使用對應協定的事件。

狀態碼	意義
200	請求成功

回應結構

欄位	類型	必填	限制	意義
`candidates`	`object[]`	否	—	—
`usageMetadata`	`object`	否	—	—

下載使用者 OpenAPI 規格

另見常見錯誤與串流回應和非同步任務。