Errors

Errors use a Google-style envelope:

{
  "error": {
    "code": 401,
    "message": "Missing API key",
    "status": "UNAUTHENTICATED"
  }
}

Common statuses you may see:

• INVALID_ARGUMENT (400): missing/invalid parameters, request too large
• UNAUTHENTICATED (401): missing/invalid API key
• PERMISSION_DENIED (403): account disabled
• RESOURCE_EXHAUSTED (429): no active plan/credits for the account
• INTERNAL (5xx): provider errors, timeouts, unexpected failures