图片理解

POST

/v1beta/models/{model-name}:generateContent

官方文档：https://ai.google.dev/gemini-api/docs/image-understanding?hl=zh-cn

请求参数

Path 参数

Query 参数

Header 参数

Body 参数application/json

示例

{
  "generationConfig": {
    "maxOutputTokens": 63000,
    "temperature": 1,
    "topP": 1,
    "thinkingConfig": {
      "thinkingBudget": 1760,
      "includeThoughts": true
    }
  },
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "请帮我分析一下图片中有哪些元素"
        },
        {
          "fileData": {
            "mimeType": "image/jpg",
            "fileUri": "https://ww3.sinaimg.cn/mw690/0083ssXily8hpug7hm5c0j30k00z643y.jpg"
          }
        }
      ]
    }
  ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/v1beta/models/:generateContent?key={{YOUR_API_KEY}}' \
--header 'Authorization: Bearer  {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "generationConfig": {
    "maxOutputTokens": 63000,
    "temperature": 1,
    "topP": 1,
    "thinkingConfig": {
      "thinkingBudget": 1760,
      "includeThoughts": true
    }
  },
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "请帮我分析一下图片中有哪些元素"
        },
        {
          "fileData": {
            "mimeType": "image/jpg",
            "fileUri": "https://ww3.sinaimg.cn/mw690/0083ssXily8hpug7hm5c0j30k00z643y.jpg"
          }
        }
      ]
    }
  ]
}'

返回响应

🟢200成功

application/json

Body

示例

{}

修改于 2026-03-24 09:54:18

图片编辑

多图融合 gemini-3-pro-image-preview 控制宽高比 +清晰度