---
title: Gemini 原生接口
description: 使用 contents 格式调用支持 Gemini 原生协议的分组。
api: "POST /v1beta/models/{model}:generateContent"
---

<RequestExample>
```bash 普通生成
curl https://sub.vcnovb.cn/v1beta/models/gemini-2.5-flash:generateContent \
  -H "x-goog-api-key: $VC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"用一句话解释机器学习。"}]}]}'
```
```bash SSE 流式
curl -N 'https://sub.vcnovb.cn/v1beta/models/gemini-2.5-flash:streamGenerateContent?alt=sse' \
  -H "x-goog-api-key: $VC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"用一句话解释机器学习。"}]}]}'
```
</RequestExample>

## 请求参数

<ParamField path="model" type="string" required>支持 Gemini 原生协议的模型 ID。示例使用 gemini-2.5-flash，需有对应分组权限。</ParamField>
<ParamField body="contents" type="array" required>内容列表，每项包含 role 与 parts；文本放在 parts 的 text 字段。</ParamField>

可通过 `generationConfig` 设置生成参数。工具调用、多模态输入和图片输出的支持范围见对应模型说明。

## 模型目录

```bash
curl https://sub.vcnovb.cn/v1beta/models \
  -H "x-goog-api-key: $VC_API_KEY"
```

## 返回结果

普通响应从 `candidates[].content.parts[]` 读取内容：文本位于 `text` 字段，图片等非文本内容按各 part 的类型读取。流式请求采用 SSE，逐条解析事件数据。

结果为空时，检查响应中的结束原因及内容审核信息。