Freischaltungen haben zusätzlich zu den normalen Rate-Limits eine harte Grenze pro Minute. Wird sie erreicht, kommt diese Meldung zurück:
Too many reveals in a short window. This cap protects the dataset and resets each minute.
Die Antwort enthält reset_seconds und einen Header Retry-After, und die Grenze setzt sich jede Minute von selbst zurück.
Warum es sie gibt
Das Freischalten ist der eine Aufruf, der aus einem geschwärzten Datensatz Kontaktdaten macht. Eine Grenze dafür, wie schnell das passieren kann, verhindert, dass der Datenbestand Datensatz für Datensatz abgegrast wird. Sie richtet sich nicht gegen dich, und es wird kein Tageskontingent verbraucht: Sie setzt sich in unter sechzig Sekunden zurück.
Das Muster, das sie vermeidet
- Exportiere statt Freischaltungen in einer Schleife. Gleicher Preis pro Kontakt, ein Auftrag, verifizierte Ausgabe. Wenn dein Agent mehr als eine Handvoll Zeilen freischaltet, sollte er einen Export erstellen.
- Bau Zufall in die Wartezeiten ein, keine engen Wiederholungen. Exponentiell wachsende Abstände mit Zufall verteilen eine Spitze über das Zeitfenster, statt erneut damit zusammenzustoßen.
- Teil die Arbeit auf. Schalte frei, was du für den nächsten Schritt brauchst, arbeite damit, und mach dann weiter.
Anweisungen im System-Prompt deines Agenten machen das automatisch. Eine Zeile wie "Für mehr als 20 Kontakte erstelle einen Export, statt einzeln freizuschalten" macht die Grenze bedeutungslos.
Wenn du sie erreichst, geht nichts verloren. Erfolgreiche Freischaltungen sind dauerhaft, die Credits dafür werden normal verbraucht, und der gescheiterte Aufruf hat nichts berechnet.