AIstudioProxyAPI does not support headless mode mainly because of Google AI Studio's anti-automation mechanism. This web platform detects headless browser features and blocks access. Specific limitations include:
- Browser Fingerprinting: Google is able to recognize headless pattern features in automated tools like Playwright.
- Interactive validation requirements: In some cases, captcha validation or other interactions need to be done manually.
Alternative solutions can be considered:
- Using the Minimized Window: Add to the startup parameters
--start-minimizedor similar options that are visible but less intrusive. - Virtual Display Solution: Simulates the display environment with a virtual frame buffer such as Xvfb.
- remote desktop control: Runs the browser instance on a remote server, managed over a VNC/RDP connection.
It should be noted that these options may increase system resource consumption or complexity, and the choice needs to be weighed against the actual requirements.
This answer comes from the articleAIstudioProxyAPI: Unlimited use of the Gemini 2.5 Pro Model APIThe
May not be reproduced without permission:AI productivity tools " Why does AIstudioProxyAPI not support headless mode? What are the alternative solutions?
English 
简体中文 
日本語 
Deutsch 
Português do Brasil