FAQ
This chapter collects the most frequently encountered error codes and exceptional scenarios when using Antigravity Tools, helping you quickly identify root causes and find solutions.
In This Chapter
| Issue Type | Page | Description |
|---|---|---|
| Account Invalid | invalid_grant & Auto-Disable | Account suddenly unavailable? Understand OAuth Token failure causes and recovery process |
| Auth Failure | 401/Auth Failed | Request rejected? Check auth_mode configuration and Header format |
| Rate Limit Errors | 429/Capacity Errors | Frequent 429s? Distinguish quota exhaustion from upstream rate limiting, use rotation to reduce impact |
| Path Errors | 404/Path Incompatible | Endpoint 404? Resolve Base URL and /v1 prefix concatenation issues |
| Streaming Exceptions | Streaming Interruption/0 Token/Signature Invalid | Response interrupted or empty? Understand proxy self-healing mechanisms and troubleshooting paths |
Recommended Learning Path
Troubleshoot by error code: When encountering a specific error, jump directly to the corresponding page.
Systematic learning: If you want a comprehensive understanding of potential issues, it's recommended to read in the following order:
- 404/Path Incompatible — The most common integration issue, usually the first pitfall
- 401/Auth Failed — Path is correct but request rejected, check auth configuration
- invalid_grant & Auto-Disable — Account-level issues
- 429/Capacity Errors — Request succeeds but is rate limited
- Streaming Interruption/0 Token/Signature Invalid — Advanced issues involving streaming responses and signature mechanisms
Prerequisites
Recommended First
- Start Local Reverse Proxy & Connect First Client — Ensure basic environment is working
- Add Accounts — Understand the correct way to add accounts
Next Steps
After troubleshooting issues, you can continue deep learning:
- High-Availability Scheduling — Use rotation and retry strategies to reduce error occurrence
- Proxy Monitor — Use the logging system to track request details
- Configuration Guide — Understand the purpose of all configuration options