[特性错误]: 转发包含 tools/function_declarations 的请求到 Gemini 时返回 400 INVALID_ARGUMENT

[zhaiiker]

版本号

v1.2.3

请求接口

Gemini

模型名称

所有

客户端/工具

Hermes CLI v3.12.13

问题描述

[Bug] 转发包含 tools/function_declarations 的请求到 Gemini 时返回 400 INVALID_ARGUMENT

环境信息

• 上游客户端：Hermes CLI v3.12.13
• 中转层：AIStudioToAPI（最新版本）
• 目标模型：gemini-3-flash-preview
• 部署方式：Docker 自建，浏览器模式运行
• 请求路径：POST /v1beta/models/gemini-3-flash-preview:streamGenerateContent

问题描述

当上游客户端（Hermes CLI）发送包含 tools / function_declarations 的请求时，AIStudioToAPI 将请求原样转发给 Google Gemini API，Gemini 返回 400 INVALID_ARGUMENT 错误，导致所有带工具调用的请求全部失败。

该问题 100% 可复现，只要请求体中携带了 tools 字段就会触发。

错误详情

Gemini API 返回的错误明确指出：function_declarations 的 parameters.required 数组中引用的属性，在对应的 parameters.properties 中未定义：

• GenerateContentRequest.tools[0].function_declarations[1].parameters.required[0]: property is not defined
• GenerateContentRequest.tools[0].function_declarations[8].parameters.required[0]: property is not defined

完整日志

以下是三次连续失败触发账号轮转的完整日志记录：

日志信息 (关键)

[INFO] 2026-05-05T04:04:30.690Z [AIStudioToAPI] - [Request] Request dispatched to browser for processing...
[INFO] 2026-05-05T04:04:30.710Z [AIStudioToAPI] - [Context#9] Received request: POST /v1beta/models/gemini-3-flash-preview:streamGenerateContent
[INFO] 2026-05-05T04:04:31.398Z [AIStudioToAPI] - [Context#9] Request processing failed: Google API returned error: 400 INVALID_ARGUMENT {"error":{"code":400,"message":"* GenerateContentRequest.tools[0].function_declarations[1].parameters.required[0]: property is not defined\n* GenerateContentRequest.tools[0].function_declarations[8].parameters.required[0]: property is not defined\n","status":"INVALID_ARGUMENT"}}
[ERROR] 2026-05-05T04:04:31.401Z [AIStudioToAPI] - [Request] Gemini real stream failed after retries. Status code: 400, message: Proxy browser error: Google API returned error: 400 INVALID_ARGUMENT {"error":{"code":400,"message":"* GenerateContentRequest.tools[0].function_declarations[1].parameters.required[0]: property is not defined\n* GenerateContentRequest.tools[0].function_declarations[8].parameters.required[0]: property is not defined\n","status":"INVALID_ARGUMENT"}}
[WARN] 2026-05-05T04:04:31.402Z [AIStudioToAPI] - ⚠️ [Auth] Request failed - failure count: 1/3 (Current account index: 9)
[INFO] 2026-05-05T04:04:31.414Z [AIStudioToAPI] - [Context#9] Sent 'error' information back to server
[INFO] 2026-05-05T04:05:13.587Z [AIStudioToAPI] - [Entrypoint] Received a request: POST /v1beta/models/gemini-3-flash-preview:streamGenerateContent
[INFO] 2026-05-05T04:05:13.593Z [AIStudioToAPI] - [Auth] API Key verification passed (from: 172.20.0.2)
[INFO] 2026-05-05T04:05:13.594Z [AIStudioToAPI] - [Browser] ⚡ User activity detected, forcing Launch detection wakeup...
[INFO] 2026-05-05T04:05:13.594Z [AIStudioToAPI] - [Request] Generation request - account rotation count: 2/10 (Current account: 9)
[INFO] 2026-05-05T04:05:13.627Z [AIStudioToAPI] - [Request] Client enabled streaming (real), entering streaming processing mode...
[INFO] 2026-05-05T04:05:13.627Z [AIStudioToAPI] - [Request] Request dispatched to browser for processing...
[INFO] 2026-05-05T04:05:13.646Z [AIStudioToAPI] - [Context#9] Received request: POST /v1beta/models/gemini-3-flash-preview:streamGenerateContent
[ERROR] 2026-05-05T04:05:14.109Z [AIStudioToAPI] - [Request] Gemini real stream failed after retries. Status code: 400, message: Proxy browser error: Google API returned error: 400 INVALID_ARGUMENT {"error":{"code":400,"message":"* GenerateContentRequest.tools[0].function_declarations[1].parameters.required[0]: property is not defined\n* GenerateContentRequest.tools[0].function_declarations[8].parameters.required[0]: property is not defined\n","status":"INVALID_ARGUMENT"}}
[WARN] 2026-05-05T04:05:14.111Z [AIStudioToAPI] - ⚠️ [Auth] Request failed - failure count: 2/3 (Current account index: 9)
[INFO] 2026-05-05T04:05:14.118Z [AIStudioToAPI] - [Context#9] Request processing failed: Google API returned error: 400 INVALID_ARGUMENT {"error":{"code":400,"message":"* GenerateContentRequest.tools[0].function_declarations[1].parameters.required[0]: property is not defined\n* GenerateContentRequest.tools[0].function_declarations[8].parameters.required[0]: property is not defined\n","status":"INVALID_ARGUMENT"}}
[INFO] 2026-05-05T04:05:14.119Z [AIStudioToAPI] - [Context#9] Sent 'error' information back to server
[INFO] 2026-05-05T04:05:33.591Z [AIStudioToAPI] - [Entrypoint] Received a request: GET /api/version/check
[INFO] 2026-05-05T04:19:22.220Z [AIStudioToAPI] - [Entrypoint] Received a request: POST /v1beta/models/gemini-3-flash-preview:streamGenerateContent
[INFO] 2026-05-05T04:19:22.226Z [AIStudioToAPI] - [Auth] API Key verification passed (from: 172.20.0.2)
[INFO] 2026-05-05T04:19:22.227Z [AIStudioToAPI] - [Browser] ⚡ User activity detected, forcing Launch detection wakeup...
[INFO] 2026-05-05T04:19:22.228Z [AIStudioToAPI] - [Request] Generation request - account rotation count: 3/10 (Current account: 9)
[INFO] 2026-05-05T04:19:22.256Z [AIStudioToAPI] - [Request] Client enabled streaming (real), entering streaming processing mode...
[INFO] 2026-05-05T04:19:22.256Z [AIStudioToAPI] - [Request] Request dispatched to browser for processing...
[INFO] 2026-05-05T04:19:22.274Z [AIStudioToAPI] - [Context#9] Received request: POST /v1beta/models/gemini-3-flash-preview:streamGenerateContent
[ERROR] 2026-05-05T04:19:22.946Z [AIStudioToAPI] - [Request] Gemini real stream failed after retries. Status code: 400, message: Proxy browser error: Google API returned error: 400 INVALID_ARGUMENT {"error":{"code":400,"message":"* GenerateContentRequest.tools[0].function_declarations[1].parameters.required[0]: property is not defined\n* GenerateContentRequest.tools[0].function_declarations[8].parameters.required[0]: property is not defined\n","status":"INVALID_ARGUMENT"}}
[WARN] 2026-05-05T04:19:22.947Z [AIStudioToAPI] - ⚠️ [Auth] Request failed - failure count: 3/3 (Current account index: 9)
[WARN] 2026-05-05T04:19:22.949Z [AIStudioToAPI] - 🔴 [Auth] Failure threshold reached (3/3)! Preparing to switch account...

[bbbugg]

在设置页面开启一下日志调试模式，重新请求一下，看一下完整的日志

[zhaiiker]

问题描述

当上游客户端通过本项目向 Gemini 发送包含 tools（Function Calling）的请求时，由于 OpenAI 的 Schema 规范较松，而 Gemini 的校验极其严格，导致请求被 Gemini 拒绝。

只要上游客户端在 parameters.required 中声明了某个字段，但该字段没有在 parameters.properties 中被明确定义，Gemini 就会直接抛出 property is not defined 错误，并导致请求 100% 失败。

问题定位 (基于 Debug 日志)

根据日志中的 Final Gemini Request，Gemini 明确指出了报错位置：

• function_declarations[1]（即 browser_click 工具）：required 包含了 "ref"，但 properties 为空 {}。
• function_declarations[8]（即 browser_type 工具）：required 包含了 "ref" 和 "text"，但 properties 里只定义了 "text"，缺失了 "ref"。

由于本项目在转发时是原样透传上游的 tools 结构，未做 Schema 过滤/清洗，导致 Gemini 接口报错 400。

核心报错日志

[INFO] 2026-05-05T05:33:49.069Z [AIStudioToAPI] - [Context#17] Request processing failed: Google API returned error: 400 INVALID_ARGUMENT {"error":{"code":400,"message":"* GenerateContentRequest.tools[0].function_declarations[1].parameters.required[0]: property is not defined\n* GenerateContentRequest.tools[0].function_declarations[8].parameters.required[0]: property is not defined\n","status":"INVALID_ARGUMENT"}}

脱敏详细报错日志

[INFO] 2026-05-05T05:33:48.664Z [AIStudioToAPI] - [Entrypoint] Received a request: POST /v1beta/models/gemini-3-flash-preview:streamGenerateContent 
[INFO] 2026-05-05T05:33:48.668Z [AIStudioToAPI] - [Auth] API Key verification passed (from: [IP SANITIZED]) 
[DEBUG] 2026-05-05T05:33:48.668Z [AIStudioToAPI] - [Registry] Found WebSocket connection for authIndex=17 
[INFO] 2026-05-05T05:33:48.671Z [AIStudioToAPI] - [Browser] ⚡ User activity detected, forcing Launch detection wakeup... 
[INFO] 2026-05-05T05:33:48.671Z [AIStudioToAPI] - [Request] Generation request - account rotation count: 7/10 (Current account: 17) 
[DEBUG] 2026-05-05T05:33:48.672Z [AIStudioToAPI] - [Proxy] Debug: incoming Gemini Body (Google Native) = {   
  "contents": [     
    {       
      "parts": [{ "text": "[USER PROMPT SANITIZED]" }],       
      "role": "user"     
    },
    {       
      "parts": [{ "text": "[MODEL RESPONSE SANITIZED]" }],       
      "role": "model"     
    }
  ],   
  "generationConfig": {},   
  "safetySettings": [     
    { "category": "HARM_CATEGORY_HARASSMENT", "threshold": "OFF" },     
    { "category": "HARM_CATEGORY_HATE_SPEECH", "threshold": "OFF" },     
    { "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT", "threshold": "OFF" },     
    { "category": "HARM_CATEGORY_DANGEROUS_CONTENT", "threshold": "OFF" }   
  ],   
  "systemInstruction": {     
    "parts": [{ "text": "[SYSTEM PROMPT SANITIZED FOR PRIVACY]" }]   
  },   
  "tools": [     
    {       
      "functionDeclarations": [         
        {           
          "description": "Navigate back to the previous page in browser history.",           
          "name": "browser_back"         
        },         
        {           
          "description": "Click on an element...",           
          "name": "browser_click",           
          "parameters": {             
            "properties": {},             
            "required": ["ref"],             
            "type": "OBJECT"           
          }         
        },
        {           
          "description": "Get browser console output...",           
          "name": "browser_console",           
          "parameters": {             
            "properties": {               
              "clear": { "type": "BOOLEAN" },               
              "expression": { "type": "STRING" }             
            },             
            "type": "OBJECT"           
          }         
        },         
        { "name": "browser_get_images" },         
        { "name": "browser_navigate", "parameters": { "properties": { "url": { "type": "STRING" } }, "required": ["url"], "type": "OBJECT" } },         
        { "name": "browser_press", "parameters": { "properties": { "key": { "type": "STRING" } }, "required": ["key"], "type": "OBJECT" } },         
        { "name": "browser_scroll", "parameters": { "properties": { "direction": { "enum": ["up", "down"], "type": "STRING" } }, "required": ["direction"], "type": "OBJECT" } },         
        { "name": "browser_snapshot", "parameters": { "properties": { "full": { "type": "BOOLEAN" } }, "type": "OBJECT" } },         
        {           
          "description": "Type text into an input field...",           
          "name": "browser_type",           
          "parameters": {             
            "properties": {               
              "text": { "type": "STRING" }             
            },             
            "required": ["ref", "text"],             
            "type": "OBJECT"           
          }         
        }
      ]     
    }   
  ] 
} 
[DEBUG] 2026-05-05T05:33:48.674Z [AIStudioToAPI] - [Adapter] Added dummy thoughtSignature for functionCall: memory 
[DEBUG] 2026-05-05T05:33:48.676Z [AIStudioToAPI] - [Proxy] Debug: Final Gemini Request (Google Native) = { [IDENTICAL TO ABOVE] }
[INFO] 2026-05-05T05:33:48.679Z [AIStudioToAPI] - [Request] Client enabled streaming (real), entering streaming processing mode... 
[INFO] 2026-05-05T05:33:48.679Z [AIStudioToAPI] - [Request] Request dispatched to browser for processing... 
[DEBUG] 2026-05-05T05:33:48.680Z [AIStudioToAPI] - [Registry] Found WebSocket connection for authIndex=17 
[DEBUG] 2026-05-05T05:33:48.680Z [AIStudioToAPI] - [Request] Forwarding request #req_1777959228668_nzrrd4e12 via connection for authIndex=17 
[INFO] 2026-05-05T05:33:48.688Z [AIStudioToAPI] - [Context#17] Received request: POST /v1beta/models/gemini-3-flash-preview:streamGenerateContent 
[DEBUG] 2026-05-05T05:33:48.690Z [AIStudioToAPI] - [Context#17] Debug: Browser received request 
[DEBUG] 2026-05-05T05:33:48.691Z [AIStudioToAPI] - [Context#17] Debug: Executing request: POST /v1beta/models/gemini-3-flash-preview:streamGenerateContent 
[DEBUG] 2026-05-05T05:33:48.693Z [AIStudioToAPI] - [Context#17] Debug: Constructed URL: /v1beta/models/gemini-3-flash-preview:streamGenerateContent?alt=sse -> https://generativelanguage.googleapis.com/v1beta/models/gemini-3-flash-preview:streamGenerateContent?alt=sse 
[INFO] 2026-05-05T05:33:49.069Z [AIStudioToAPI] - [Context#17] Request processing failed: Google API returned error: 400 INVALID_ARGUMENT {"error":{"code":400,"message":"* GenerateContentRequest.tools[0].function_declarations[1].parameters.required[0]: property is not defined\n* GenerateContentRequest.tools[0].function_declarations[8].parameters.required[0]: property is not defined\n","status":"INVALID_ARGUMENT"}} 
[ERROR] 2026-05-05T05:33:49.072Z [AIStudioToAPI] - [Request] Gemini real stream failed after retries. Status code: 400, message: Proxy browser error: Google API returned error: 400 INVALID_ARGUMENT {"error":{"code":400,"message":"* GenerateContentRequest.tools[0].function_declarations[1].parameters.required[0]: property is not defined\n* GenerateContentRequest.tools[0].function_declarations[8].parameters.required[0]: property is not defined\n","status":"INVALID_ARGUMENT"}} 
[WARN] 2026-05-05T05:33:49.072Z [AIStudioToAPI] - ⚠️ [Auth] Request failed - failure count: 2/3 (Current account index: 17) 
[INFO] 2026-05-05T05:33:49.076Z [AIStudioToAPI] - [Context#17] Sent 'error' information back to server

[bbbugg]

ghcr.io/ibuhub/aistudio-to-api:preview-20260505-082706 可以看一下，这个镜像还有问题吗，之前把参数过滤错了。

[github-actions]

✅ 此 Issue 已在版本 v1.2.4 中修复 (通过 PR #155)。
✅ This Issue has been fixed in version v1.2.4 (via PR #155).