Gemini 聊天 (generateContent)

Google Gemini 原生聊天接口。传入 contents 对话历史即可生成回复。

文件分析（多模态文件输入）

Gemini 的文件识别不是插件/工具，而是把文件作为 contents[].parts 里的一个 part。小文件用 inline_data（base64），较大文件或复用用 file_data（先经 Files 接口上传拿到 file_uri）。两者都需指定 mime_type。

兼容性：inline_data（base64）最通用最稳；file_data 的 file_uri 需先上传文件获得。Gemini 原生格式无 image/document 之分，统一按 mime_type 区分文件类型。

base64（inline_data）

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "请分析这个文件" },
        { "inline_data": { "mime_type": "application/pdf", "data": "<BASE64_无前缀>" } }
      ]
    }
  ]
}

图片同理，把 mime_type 换成 image/png、image/jpeg 等即可。

文件引用（file_data）

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "请分析这个文件" },
        { "file_data": { "mime_type": "application/pdf", "file_uri": "https://generativelanguage.googleapis.com/v1beta/files/xxx" } }
      ]
    }
  ]
}

常见 mime_type：图片 image/png、image/jpeg、image/webp；文档 application/pdf；纯文本 text/plain。路径参数 {model} 用支持多模态的模型，如 gemini-2.5-pro、gemini-2.5-flash。

curl --location 'https://api.openai-hub.net/v1beta/models/gemini-3-pro-image-preview:generateContent' \ --header 'Authorization: Bearer sk-0ABIEXVjh9****Qckjy' \ --header 'Content-Type: application/json' \ --data '{ "contents": [ { "parts": [ { "text": "生成一张 16:9 超宽电影海报，只能输出横图。" } ] } ], "generationConfig": { "responseModalities": [ "TEXT", "IMAGE" ], "imageConfig": { "aspectRatio": "16:9" } } }'

文件分析（多模态文件输入）

base64（inline_data）

文件引用（file_data）

请求参数

返回响应

Gemini 聊天 (generateContent)

文件分析（多模态文件输入）#

base64（inline_data）#

文件引用（file_data）#

请求参数

返回响应

文件分析（多模态文件输入）

base64（inline_data）

文件引用（file_data）