用途：面向需要通过 Google Gemini API（Base URL：https://generativelanguage.googleapis.com/v1beta）调用多模态生成式 AI 的开发者，提供从文本生成到嵌入的 REST 调用示例。
主要能力：基础文本生成（generateContent）；携带 system_instruction 的对话引导；通过 user/model 交替角色的多轮对话；使用 streamGenerateContent?alt=sse 的流式响应；以 responseMimeType 和 responseSchema 强制结构化 JSON 输出；以内联 base64 图像进行视觉分析（超过约 20 MB 需先用 Files API 上传并以 file_uri 引用）；函数调用（tools 中声明 function_declarations，返回 functionCall）；embedContent 生成嵌入；countTokens 预估令牌；以及 temperature、topP、maxOutputTokens 与 safetySettings 等生成与安全设置。
模型：gemini-2.5-pro（推理最强，1M 上下文）、gemini-2.5-flash（快速均衡，1M）、gemini-2.5-flash-lite（低延迟高吞吐，1M）、gemini-2.0-flash（上一代）、gemini-1.5-pro（旧版长上下文，2M）；嵌入模型 text-embedding-004（768 维）与 gemini-embedding-001。
用法：需设置 GEMINI_TOKEN，推荐使用 x-goog-api-key 请求头而非 ?key= 查询参数；用 curl 发送 JSON 请求体。排障可运行 zero doctor check-connector --env-name GEMINI_TOKEN 或 zero doctor check-connector --url https://generativelanguage.googleapis.com/v1beta/models --method GET。响应中的 usageMetadata 提供 promptTokenCount、candidatesTokenCount、totalTokenCount。
限制：所有示例均假定已设置 GEMINI_TOKEN；文档强调设置 maxOutputTokens 以控制成本、长上下文先 countTokens 估算，并定期查看 Google AI Studio 用量。资料未提供具体收费标准、价格或配额数据，暂未提供。