> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codeflare.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini

> 使用原生 generateContent、流式与 token 计数入口。

## 文本生成

选择支持 `gemini` 的平台模型。使用网关根地址、`x-goog-api-key` 和 Gemini 的 `contents` 格式，不要把 OpenAI SDK 的 `/v1` Base URL 直接拼接到 `/v1beta` 前。

```bash cURL theme={null}
curl "https://YOUR-REGION.example/v1beta/models/MODEL_ID:generateContent" \
  -H "x-goog-api-key: $CODEFLARE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"contents":[{"role":"user","parts":[{"text":"Hello"}]}],"generationConfig":{"maxOutputTokens":256}}'
```

`MODEL_ID` 应替换为平台模型 ID；包含特殊字符时需按 URL 路径段编码。响应采用 Gemini 原生候选格式。

## 流式输出与计数

使用 `POST /v1beta/models/MODEL_ID:streamGenerateContent?alt=sse` 读取流式结果；模型路由需要支持流式。`POST /v1beta/models/MODEL_ID:countTokens` 的计数请求需要渠道能力，不收生成费用。

网关也支持 `/v1/models/MODEL_ID:ACTION` 路径。`GET /v1beta/models` 返回 Gemini 风格目录；`GET /v1/models` 保留 OpenAI 风格。

## 能力边界

多模态输入、推理、工具和其他生成配置受所选模型与上游能力限制。此生成入口不等于支持供应商的所有媒体服务。不要自动重试不确定执行的请求。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.