Google Gemini API图文请求Base64解码错误修复问询

• 检查Base64编码完整性
  确保图片的Base64编码无截断、换行或额外字符。用系统命令直接生成编码：

  # macOS/Linux系统
  base64 -i 目标图片路径 > 输出文件名.txt
  # Windows PowerShell
  [Convert]::ToBase64String([IO.File]::ReadAllBytes("目标图片路径")) | Out-File 输出文件名.txt
  

  复制编码时要完整复制所有内容，不要遗漏首尾字符。

• 匹配图片格式与MIME类型
  确认请求中inline_data.mime_type的值和图片实际格式严格对应：

  • JPG/JPEG对应image/jpeg
  • PNG对应image/png
  • WebP对应image/webp
    格式不匹配会直接触发解码失败。

• 校验请求JSON结构
  确保请求体的contents数组结构完全符合API要求，示例正确结构：

  {
    "contents": [
      {
        "parts": [
          { "text": "请描述这张图片" },
          {
            "inline_data": {
              "mime_type": "image/jpeg",
              "data": "完整的纯Base64编码字符串"
            }
          }
        ]
      }
    ]
  }
  

  用EchoAPI的JSON校验功能检查是否存在语法错误，比如多余逗号、引号不闭合等。

• 移除Base64前缀
  若使用在线工具生成Base64，注意去除data:image/xxx;base64,这类前缀，仅保留纯编码字符串填入data字段。

• 测试小尺寸图片
  先用几百KB以内的小图片测试，排除因图片过大导致的编码或传输异常，确认可行后再尝试大尺寸图片。

内容的提问来源于stack exchange，提问作者Tech Dominion