POST /v1beta/models/{model}:generateContent

Gemini媒体识别

Gemini 图像、PDF、音频、视频识别请求

注意：仅支持通过 inlineData 以 base64 方式上传图像、PDF、音频、视频，不支持 fileData.fileUri 或 File API。

认证

使用 Bearer Token 认证，格式：Authorization: Bearer sk-xxxxxx

路径参数

参数 类型 必需 说明
model string 是 模型名称，如 gemini-2.5-pro

请求示例：图像识别

cURL
curl -X POST "https://your-base-url/v1beta/models/gemini-2.5-pro:generateContent" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "请描述这张图片的内容"
          },
          {
            "inlineData": {
              "mimeType": "image/jpeg",
              "data": "/9j/4AAQSkZJRgABAQ..."
            }
          }
        ]
      }
    ]
  }'

响应示例

200 OK
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "这张图片展示了一幅美丽的风景..."
          }
        ]
      },
      "finishReason": "STOP",
      "safetyRatings": []
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 258,
    "candidatesTokenCount": 45,
    "totalTokenCount": 303
  }
}