Gemini (原生格式)-可文件分析

提示

注意：Gemini原生请求参数支持：下划线命名和小驼峰命名。我们平台统一使用小驼峰命名参数，否则部分参数可能无法被正确识别。
例如：tool_config（❌）和toolConfig (✅)

本文档只列出基础参数，更多参数和使用示例，请查阅 Gemini官方开发手册

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Header 参数

Body 参数application/json

示例

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "你好吗"
        }
      ]
    }
  ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "candidates": [
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "text": "你好！我很好，谢谢。你呢？\n\n(Nǐ hǎo! Wǒ hěn hǎo, xièxie. Nǐ ne?)\n(Hello! I'm very good, thank you. How about you?)"
                    }
                ]
            },
            "finishReason": "STOP",
            "avgLogprobs": -0.52286293927360983
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 2,
        "candidatesTokenCount": 51,
        "totalTokenCount": 91,
        "trafficType": "ON_DEMAND",
        "promptTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 2
            }
        ],
        "candidatesTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 51
            }
        ],
        "thoughtsTokenCount": 38
    },
    "modelVersion": "gemini-2.5-flash",
    "createTime": "2025-11-24T17:50:00.796019Z",
    "responseId": "yJokafPKMMLJ4_UP1bqJ-AU"
}