Gemini 聊天格式

​

Gemini 内容生成 (Gemini Native Format)

​

📌 基础信息

• 接口地址: POST /v1beta/models/{model}:generateContent/
• 请求参数 (Path):
  • model: 模型名称，例如 gemini-3-pro-image-preview。
• 认证方式: Bearer Token
• 内容类型: application/json

​

📥 请求参数 (Request Body)

​

📤 响应结果 (Response)

​

📝 请求示例 (生成图像)

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "draw a futuristic city at sunset"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "4K"
    },
    "thinkingConfig": {
      "includeThoughts": true
    }
  }
}

​

💡 开发者建议

1. 思维链返回: 通过设置 includeThoughts: true，你可以看到模型在绘图前是如何理解你的需求并进行“构思”的，这对于调试复杂提示词非常有用。
2. 多模态响应: 在 responseModalities 中同时包含 TEXT 和 IMAGE 时，模型会先给出描述性文字，再生成对应的图像。
3. 模型版本: 请确保路径中的 {model} 参数与您当前使用的 API 权限相匹配。