Überspringen zum Inhalt
DE
API-Schlüssel
Dokumentation durchsuchen

Erste Schritte

Agententest und Kontoverknüpfung

Versuchen Sie eine Google-Suche, bevor Sie sich anmelden, und verbinden Sie dann ein Besitzerkonto, um dasselbe CLI-Profil zu verwenden.

Auf dieser Seite

1. Bestehender Zugriff prüfen

Führen Sie diesen kostenlosen Check in der Umgebung Ihres Agenten aus. Wenn data.accessVerified true ist und Google Search erlaubt ist, verwenden Sie diesen Zugriff erneut und springen Sie zu Schritt 3. Wenn kein gespeichertes Profil vorhanden ist, fahren Sie mit Schritt 2 fort. Fortsetzen des ausstehenden oder blockierten Zugriffs mit dem unten stehenden Wiederherstellungsabschnitt.

Überprüfen Sie dieses Profil
flashdata auth status --json --non-interactive

Behalten Sie das gleiche Profil

Arbeitszugriffsberichte data.accessVerified: true, access: ready in data.identity.identity und google_search in data.identity.permittedSources.

Diese Befehle verwenden das Standardprofil und funktionieren in Bash oder PowerShell. Fügen Sie für ein vorhandenes benanntes Profil oder benutzerdefiniertes Zustandsverzeichnis den gleichen --profile NAME und --state-dir ABSOLUTE_PATH an jeden Befehl an, einschließlich derjenigen in einem neuen Terminal.

FLASHDATA_API_KEY hat Vorrang vor dem gespeicherten Schlüssel. Lass diese Variable ungesetzt, wenn du den Testzugang und die Übergabe der Zugangsdaten dieses Profils prüfst. Verwende denselben Betriebssystembenutzer und bewahre das private Zustandsverzeichnis auf; es enthält Zugangsdaten, den Registrierungsnachweis und den Ausführungsverlauf.

credentialProtection in auth status untersuchen. Windows verwendet DPAPI, macOS verwendet Keychain, und Headless Linux kann eine inhaberspezifische Anmeldedatei verwenden. Ein verfügbarer OS-Speicher kann mit --credential-store os benötigt werden.

Verwenden Sie stattdessen einen vorhandenen Besitzerschlüssel

Eine Person an einem Terminal kann einen Schlüssel durch die versteckte Eingabeaufforderung unten importieren und die Testregistrierung und -beanspruchung überspringen. Agenten sollten es auf stdin mit --api-key-stdin --non-interactive aus ihrem geheimen Speicher liefern; niemals einen Schlüssel in Argumente oder Chat setzen.

Wenn das Profil bereits einen anderen Zugriff hat, überprüfen Sie es, bevor Sie auth login --replace verwenden. Das Importieren eines anderen Schlüssels ist nicht die Claim Handoff. MCP OAuth ist ebenfalls eine separate Hostverbindung.

Versteckte Tastenaufforderung · menschliches Terminal
flashdata auth login
flashdata auth status --json --non-interactive

2. Beginn einer förderfähigen Prüfung

Führen Sie discover zuerst aus. Überprüfen Sie data.onboardingAvailable und die Zulage in data.onboarding.trial. Wenn Onboarding verfügbar ist, führen Sie init einmal für Google Search aus. Der Server prüft die Berechtigung; der CLI speichert den temporären Schlüssel, ohne die Anmeldung zu öffnen oder eine Abfrage einzureichen.

Verfügbarkeit prüfen · kostenlos
flashdata discover --json --non-interactive
Befristeter Zugang
flashdata init --name "Research assistant" --scopes google_search --json --non-interactive

Überprüfen Sie den Registrierungsbeleg

Erwarten Sie ok: true, data.status: trial und google_search in data.connection.scopes. Lesen Sie data.connection.trialExpiresAt und data.startingAllowanceCredits. Der Schlüssel wird lokal gespeichert, nicht gedruckt. Wenn data.currentBalanceAvailable false ist, führen Sie die Überprüfung des freien Gleichgewichts erneut durch, bevor Sie abfragen.

Verwenden Sie bereits eingerichteten Zugriff erneut. Kennzeichnen Sie die erste Agentenregistrierung mit --client codex --audience coding oder --client openclaw --audience personal. Behalten Sie bei einem erneuten Versuch exakt dieselbe Eingabe bei; diese Angaben erteilen keine Berechtigungen.

Prüfungszulage und Höchstbeträge

Anfrageäquivalente teilen sich den gleichen Startguthabenstand; es handelt sich nicht um verbleibende Anfragen oder unabhängige Quoten. Nur Eigentümerquellen wie YouTube Download können keine Testkredite ausgeben.

BegrenzungWas zu überprüfen ist
Credits / VerfallAktuelle Standardwerte: 1 Gutschrift für 72 Stunden. Lesen Sie Entdeckung für die Gewährung und Lebensdauer; die Quittung gibt den Ablauf und gewährte Quellen.
Registrierung3-Registrierungen pro IP pro 24-Stunden, die von Benutzern dieser IP geteilt werden. Die globale Trial-Cap kann auch neue Registrierungen unterbrechen.
ZeitgleichheitHalten Sie die Probearbeit sequentiell: ein Gegenstand pro Batch und ein ausstehender Auftrag. Überprüfen Sie die zurückgegebenen Limits, bevor Sie mehr einreichen.

3. Probieren Sie eine Suche

Vorschau zuerst. data.estimateAvailable, einen verfügbaren google_search Preis in data.estimate.prices und availableCredits für estimatedCredits. Stoppen Sie, wenn ein Scheck fehlschlägt. Die Vorschau ist kostenlos; der nächste Befehl sendet eine Suche.

Check-Balance und Kosten · keine Abfrage
flashdata account balance --json --non-interactive
flashdata search "battery recycling" --num 5 --dry-run --json --non-interactive
Eine Suche · bis zu fünf Ergebnisse
flashdata search "battery recycling" --num 5 --run-id trial-search --json --non-interactive

Ergebnis prüfen

Prüfen Sie ok: true und data.status: done. Titel, Links und Auszüge stehen in data.results[].organic, der Verbrauch in data.usage.credits. Leere organische Ergebnisse sind gültig. Vor der Kontoverknüpfung liefert die identische Aufgabe mit trial-search das gespeicherte Ergebnis. Behalten Sie Profil und Zustand bei und speichern Sie benötigte Testergebnisse.

Überprüfen Sie den Restbetrag · frei
flashdata account balance --json --non-interactive

4. Halten Sie den Zugriff mit einem Besitzerkonto

Anspruch vor dem Versuch läuft ab, wenn Sie eine fortgesetzte oder wiederkehrende Nutzung wünschen. Wenn der Besitzer bereit ist, führen Sie dies im ursprünglichen Profil aus. Teilen Sie nur data.claimUrl und data.confirmationCode mit ihnen; data.expiresAt gibt die Frist an.

Der Link dauert 15 Minuten, oder bis die Testversion abläuft, wenn früher. Das Erstellen des Links genehmigt keinen Zugriff oder Kauf von Credits.

Erstellen Sie einen Claim-Link, wenn der Besitzer bereit ist
flashdata auth claim --json --non-interactive

Genehmigen im Browser

  1. Der Besitzer öffnet den Link und meldet sich an oder erstellt ein neues Konto und überprüft die E-Mail. Eine neue Anmeldung nimmt den Anspruch nach der Überprüfung wieder auf.
  2. Überprüfen Sie das Konto, das auf der Anspruchsseite angezeigt wird. Verwenden Sie für einen anderen oder neuen Besitzer eine separate Browsersitzung. Das angemeldete Konto ist das Konto, das für spätere Anfragen bezahlt wird.
  3. Geben Sie den achtstelligen Code auf dieser Seite ein, überprüfen Sie die Produktberechtigungen und den Zugriff auf Shared-Balance und genehmigen Sie dann. Der Eigentümer übernimmt die Anmeldung, die rechtliche Annahme, die E-Mail-Überprüfung und die Zustimmung.

Beenden Sie im Original-Terminal

Führen Sie finish nach der Genehmigung innerhalb von 24-Stunden im Originalprofil aus. Der CLI speichert den Besitzerschlüssel, überprüft ihn in einem neuen Prozess und bestätigt die Installation. Es wird kein Schlüssel aus dem Browser kopiert.

Speichern und Verifizieren des Eigentümerzugriffs
flashdata auth finish --wait --timeout 10m --json --non-interactive
Dann überprüfen Sie von einem neuen Terminal · gleiche OS Benutzer und Profil
flashdata auth status --json --non-interactive
flashdata account balance --json --non-interactive

Bestätigen Sie den Eigentümer und das Gleichgewicht

Überprüfen Sie in auth status die beabsichtigte accountId und die gewährten Scopes sowie die folgenden Felder. Lesen Sie das frische Guthaben separat; zukünftige Anfragen geben die geteilten Credits des Eigentümers aus. Ungenutzte temporäre Kredite werden nicht übertragen. Ein neues konto folgt der normalen anmeldeberechtigung; die behauptung fügt kein zusätzliches anmeldezuschuss hinzu.

Die Forderung ändert das abgerechnete Konto. Für eine neue Aufgabe unter dem Besitzer wählen Sie einen neuen Lauf ID. Die Wiederverwendung eines Testlaufs ID gibt run_account_mismatch zurück, ohne eine weitere Abfrage einzureichen; es wird dieser Lauf nicht an den Besitzer übertragen.

Erwartete Felder · Antwortauszug
{
  "ok": true,
  "data": {
    "accessVerified": true,
    "identity": {
      "identity": {
        "accountType": "owned",
        "access": "ready",
        "installed": true,
        "recurringAllowed": true
      }
    }
  }
}

Wählen Sie Produktberechtigungen

Der HTTP-Berechtigungskatalog unterscheidet trialEligible und ownerAllowed. Fordere vor der ersten Registrierung nur die für deine Aufgabe benötigten Quellen an. requestedScopes enthält die angeforderten Berechtigungen; scopes beschreibt den aktuellen Zugriff des Schlüssels. Neue Produkte benötigen eine ausdrückliche Freigabe.

Die Freigabe erlaubt die Nutzung des gemeinsamen Kontoguthabens einschließlich gekaufter Credits. Quellenbeschränkungen richten kein Ausgabenlimit pro Agent ein. MCP OAuth ist eine separate Verbindung und verknüpft dieses CLI-Profil nicht mit dem Konto.

Benötigen Sie nur YouTube Download?

Verwenden Sie einen Besitzerschlüssel mit youtube_download-Berechtigung, importieren Sie ihn und konfigurieren Sie dann den Zielspeicher. Download verwendet keine temporären Testkredite.

CLI 1.2.1 erfordert immer noch eine testfähige Quelle für init. Verwenden Sie für das reinen Download-Onboarding vor der Anmeldung den HTTP-Anspruchsfluss in auth.md. Fügen Sie keine unabhängige Testquelle hinzu, nur um diese Client-Beschränkung zu umgehen.

Fortsetzung eines gestoppten Flusses

Was aufgehört hatNächste Maßnahme
RegisterFür 429 warten Sie auf Retry-After. Für eine verlorene Antwort, wiederholen Sie init mit dem gleichen Profil, Beweis und genaue Eingabe. Behalten Sie den bestehenden Zustand bei; wechseln Sie nicht die IP oder starten Sie eine Ersatzstudie.
SuchenPrüfen Sie unten trial-search. Ein Timeout beweist nicht, dass keine Arbeit angenommen wurde. Ändern Sie die Ausführungs-ID nicht, um einen erneuten Versuch zu erzwingen.
ForderungsverbindlichkeitenWenn der Link abgelaufen ist, aber die Testversion gültig ist, erstellen Sie einen neuen Link im selben Profil, wenn der Besitzer bereit ist. Überprüfen Sie den angemeldeten Besitzer vor der Genehmigung.
ÜbergabeNach der Genehmigung führen Sie auth finish im Originalprofil innerhalb von 24 Stunden erneut aus. Eine ausstehende Genehmigung, ein unterbrochenes Warten oder eine verlorene Bestätigung erfordern keine Neuregistrierung.
Abgelaufener/verlorener ZustandVerwenden Sie für eine abgelaufene Testversion oder Übergabe oder ein verlorenes privates Staatsverzeichnis die vom Eigentümer genehmigte Wiederverbindung oder importieren Sie einen Eigentümerschlüssel.
Überprüfen Sie die gespeicherte Suche · keine neue Abfrage
flashdata runs show trial-search --json --non-interactive