Gemini - 图片理解（fileData 方式）

POST

/v1beta/models/gemini-2.0-flash:generateContent

Gemini 图片理解 - 使用 Files API 上传后的 fileUri（适合大文件）

Request

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://newapi.mexxxxai.win/v1beta/models/gemini-2.0-flash:generateContent?key={{GEMINI_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "contents": [
    {
      "parts": [
        {"fileData": {"mimeType": "image/jpeg", "fileUri": "https://your-file-uri-from-files-api"}},
        {"text": "这张图片里有什么内容？"}
      ]
    }
  ],
  "generationConfig": {"temperature": 0.4, "maxOutputTokens": 1024}
}'

Response Example

{
  "candidates": [
    {
      "content": {
        "parts": [{"text": "图片显示了一张产品设计图，包含多个UI组件的布局示意图，主要以蓝色和白色为主色调，整体风格简洁现代。"}],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 270,
    "candidatesTokenCount": 38,
    "totalTokenCount": 308
  }
}

Modified at 2026-04-02 11:32:32

Gemini - 图片理解（inlineData Base64）

Gemini - 视频理解（fileData）