From 30d9cbacdfb33def466344dc9fdf3bb1c4b9b898 Mon Sep 17 00:00:00 2001
From: MudassarTariq <mudassir@jfreaks.com>
Date: Wed, 11 Nov 2026 21:46:14 +0500
Subject: [PATCH] docs: README 429 comment mentions overage

A 429 only happens when no credits are left: the free plan's daily credits, or a paid plan's credits with overage off or at its cap. Overage is on by default on all paid plans (the Allow Surcharge Usage toggle on the dashboard), and the API has no per-second rate limits.
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 14594dc..e3725cf 100644
--- a/README.md
+++ b/README.md
@@ -519,7 +519,7 @@ try {
   if (error instanceof UnauthorizedError) {
     console.error(error.apiMessage);
   } else if (error instanceof RateLimitError) {
-    // 429: credits used up for this period (or the overage limit reached), not a per-second limit
+    // 429: no credits left (overage off or at its cap), not a per-second limit
     console.error("Out of API credits:", error.apiMessage);
   } else {
     throw error;