聊天（Chat）
Gemini 文本聊天
按 Gemini v1beta generateContent 格式创建文本或多模态回复，适合 Gemini SDK、Gemini CLI 和原生 Gemini 客户端。
POST
/v1beta/models/gemini-2.5-pro:generateContentAuthorizationBearerAuth
BearerAuth
使用 Bearer Token 认证。
Authorization: Bearer sk-xxxxxx使用 Bearer Token 认证，格式：Authorization: Bearer sk-xxxxxx。
Bodyapplication/json
modelrequired路径中的 Gemini 模型名，例如 gemini-2.5-pro。
Gemini contents 数组，包含 role 和 parts。
字段结构
rolestring内容角色，例如 user、model。
partsarray<object>内容片段数组，常见字段为 text 或 inlineData。
Authorization
BearerAuth请求头使用 Authorization，值为 Bearer <token>。 Token 来自控制台“API 密钥”，不是登录态，也不是管理员密钥。
In: header
Request Body
application/jsonmodelrequired路径中的 Gemini 模型名，例如 gemini-2.5-pro。
contentsrequiredGemini contents 数组，包含 role 和 parts。
generationConfig温度、最大输出、候选数等生成参数。
systemInstruction系统指令。
safetySettings安全策略设置。
tools工具定义。
Response Body
application/jsoncandidates候选回复。文本通常位于 candidates[0].content.parts[0].text。
usageMetadataToken 使用统计。
modelVersion模型版本。
说明
Pixel API 使用 Bearer API Key 鉴权；如果客户端原本使用 key 查询参数，建议改为 Authorization 请求头。