# Gemini generateContent 基础接口

`POST /v1beta/models/{model}:generateContent`

Gemini 原生 `generateContent` 入口。文本、多模态、图片生成、结构化输出、工具、搜索、URL Context、Code Execution，以及 PDF、音频、视频理解，都按 Gemini 的 payload 提交。

## 请求格式
模型名放在路径 `{model}` 中。请求体使用 Gemini 原生结构，核心字段是 `contents`，每条内容由 `parts` 组成。

## 适用位置
- 从 Gemini 原生 SDK 或 AI Studio 迁移。
- 保留 Gemini 原生请求结构。
- 使用贴近 Gemini 语义的多模态和工具字段。

## 验证顺序
1. 用基础文本请求确认模型和鉴权。
2. 加入 `generationConfig`、`tools`、`responseSchema`、搜索或媒体 parts。
3. 图片、音频、视频理解仍走这条，只是 payload 不同。

## 读取结果
响应通常包含 `candidates`。文本在 candidates 的 content parts 中；图片结果可能在 inlineData 或文件引用中，接入时按返回结构解析。

Tags: Gemini 原生接口