# Gemini 文本聊天

来源: https://docs.aicentos.com/api/chat/gemini/text

Language: zh-CN

> Gemini 原生格式的文本生成接口：端点、鉴权与请求示例

Gemini 原生格式的文本生成接口。

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

## 鉴权

Bearer Token：API Key 在控制台「令牌管理」获取，放在请求头 `Authorization`。

## Path 参数

| 参数    | 类型     | 说明                       |
| ----- | ------ | ------------------------ |
| model | string | 模型 ID，如 `gemini-2.0-pro` |

## 请求

`Content-Type: application/json`

```bash
export AICENTOS_API_KEY="sk-your-aicentos-api-key"

curl -X POST "https://aicentos.com/v1beta/models/gemini-2.0-pro:generateContent" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AICENTOS_API_KEY" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{ "text": "用一句话介绍你自己" }]
      }
    ]
  }'
```

请求结构（`contents` / `parts`）与 Gemini 官方一致。

## 响应

回复取 `candidates[0].content.parts[0].text`，用量在 `usageMetadata`：

```json
{
  "candidates": [
    {
      "content": {},
      "finishReason": "string",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 0,
    "candidatesTokenCount": 0,
    "totalTokenCount": 0
  }
}
```