Ga naar de inhoud
NL
API-sleutel ophalen
Documentatie bekijken

Aan de slag

Proefgebruik en accountkoppeling

Probeer een Google-zoekopdracht voordat u zich aanmeldt, sluit dan een eigenaaraccount aan om hetzelfde CLI-profiel te blijven gebruiken.

Op deze pagina

1. Bestaande toegang controleren

Controleer deze gratis in de omgeving van je agent. Als data.accessVerified true is en Google Search is toegestaan, hergebruik die toegang en ga naar stap 3. Ga door met stap 2 zonder opgeslagen profiel. Hervatten hangende of geblokkeerde toegang met behulp van de herstel sectie hieronder.

Selecteer dit profiel
flashdata auth status --json --non-interactive

Hetzelfde profiel behouden

Werktoegang rapporten data.accessVerified: true, access: ready in data.identity.identity, en google_search in data.identity.permittedSources.

Deze commando's gebruiken het standaardprofiel en werken in Bash of PowerShell. Voor een bestaand genoemd profiel of aangepaste status directory, voeg dezelfde --profile NAAM en --state-dir ABSOLUTE_PATH toe aan elke opdracht, inclusief die in een nieuwe terminal.

FLASHDATA_API_KEY heeft voorrang op de opgeslagen sleutel. Laat deze variabele oningesteld wanneer je de proefperiode en de overdracht van inloggegevens voor dit profiel test. Gebruik dezelfde OS-gebruiker en bewaar de privémap met statusgegevens; deze bevat inloggegevens, het registratiebewijs en de uitvoeringsgeschiedenis.

Inspecteer credentialProtection in auth status. Windows maakt gebruik van DPAPI, macOS maakt gebruik van Keychain, en hoofdloze Linux mag een eigenaar-alleen credential bestand gebruiken. Een beschikbare OS store kan worden vereist met --credential-store os.

Gebruik een bestaande eigenaarsleutel in plaats daarvan

Een persoon op een terminal kan een sleutel importeren via de verborgen prompt hieronder en de trial registratie overslaan en claimen. Agenten moeten het leveren op stdin met --api-key-stdin --non-interactive uit hun geheime winkel; nooit een sleutel in argumenten of chat.

Als het profiel al verschillende toegang heeft, bekijk het dan voordat u auth login --replace gebruikt. Het importeren van een andere sleutel is niet de claim overdracht. MCP OAuth is ook een aparte hostverbinding.

Verborgen sleutel prompt · menselijke terminal
flashdata auth login
flashdata auth status --json --non-interactive

2. Start één studie die in aanmerking komt

Start discover eerst. Controleer data.onboardingAvailable en de vergoeding in data.onboarding.trial. Als onboarding beschikbaar is, voer dan init één keer uit voor Google Search. De server controleert de subsidiabiliteit; de CLI slaat de tijdelijke sleutel op zonder zich te openen of een query in te dienen.

Beschikbaarheid controleren · gratis
flashdata discover --json --non-interactive
Tijdelijke toegang starten
flashdata init --name "Research assistant" --scopes google_search --json --non-interactive

Controleer het registratiebewijs

Verwacht ok: true, data.status: trial en google_search in data.connection.scopes. Lees data.connection.trialExpiresAt en data.startingAllowanceCredits. De sleutel wordt lokaal opgeslagen, niet afgedrukt. Als data.currentBalanceAvailable false is, voer dan de vrije balanscontrole opnieuw uit alvorens te vragen.

Gebruik bestaande toegang opnieuw. Voeg bij de eerste registratie van een agent --client codex --audience coding of --client openclaw --audience personal toe om de herkomst aan te geven. Behoud bij een nieuwe poging exact dezelfde invoer; deze labels verlenen geen rechten.

Proefvergoeding en -limieten

Het verzoek om equivalenten deelt hetzelfde uitgangskredietsaldo; het zijn geen resterende verzoeken of onafhankelijke quota's. Alleen-eigenaar bronnen zoals YouTube Download kunnen geen trial credits uitgeven.

MaximumhoeveelheidWat te controleren
Dankbetuigingen / vervaldatumHuidige standaardwaarden: 1-krediet voor 72-uren. Lees ontdekking voor de subsidie en de levensduur; het ontvangstbewijs geeft het verstrijken en verleende bronnen.
Registratie3 registraties per IP per 24 uren, gedeeld door gebruikers van dat IP. De wereldwijde trial cap kan ook nieuwe registraties onderbreken.
ConcurrencyHoud de proefarbeid sequentiële: één item per batch en één in afwachting van werk. Controleer retourlimieten voordat u meer invoert.

3. Probeer één zoekopdracht

Eerst een voorbeeld. Vereist data.estimateAvailable, een beschikbare google_search prijs in data.estimate.prices, en availableCredits dekking estimatedCredits. Stop als een cheque mislukt. Het voorbeeld is gratis; het volgende commando geeft een zoekopdracht.

Controleer saldo en kosten · geen query
flashdata account balance --json --non-interactive
flashdata search "battery recycling" --num 5 --dry-run --json --non-interactive
Eén zoekopdracht · maximaal vijf resultaten
flashdata search "battery recycling" --num 5 --run-id trial-search --json --non-interactive

Het resultaat controleren

Verwacht ok: true en data.status: done. Lees titels, links en knipsels van data.results[].organic, en de lading van data.usage.credits. Lege biologische resultaten zijn geldig. Voordat het claimen, het herhalen van deze exacte taak met trial-search geeft het opgeslagen resultaat. Houd het profiel en de status, en behoud alle trial resultaten die u nodig hebt.

Controleer het resterende saldo · vrij
flashdata account balance --json --non-interactive

4. Toegang houden met een eigenaar account

Claim voordat het proces verloopt als u wilt dat het gebruik wordt voortgezet of herhaald. Als de eigenaar klaar is, voer dit dan in het oorspronkelijke profiel uit. Deel alleen data.claimUrl en data.confirmationCode met hen; data.expiresAt geeft de deadline.

De link duurt 15 minuten, of tot de proef verloopt als eerder. Het maken van de link keurt toegang of aankoop credits niet goed.

Maak een claimlink aan als de eigenaar klaar is
flashdata auth claim --json --non-interactive

Goedkeuring in de browser

  1. De eigenaar opent de link en tekent zich aan, of maakt een nieuw account aan en controleert e-mail. Een nieuwe aanmelding hervat de claim na verificatie.
  2. Controleer de account die op de claim pagina. Voor een andere of nieuwe eigenaar, gebruik een aparte browsersessie. De ingelogde rekening is de rekening die zal betalen voor latere verzoeken.
  3. Voer de achtcijferige code in op die pagina, bekijk productmachtigingen en toegang tot gedeelde balans, en keur het vervolgens goed. De eigenaar behandelt aanmelding, wettelijke aanvaarding, e-mail verificatie en toestemming.

In de oorspronkelijke terminal afmaken

Na goedkeuring, voer finish in het oorspronkelijke profiel binnen 24 uren. De CLI slaat de sleutel van de eigenaar op, controleert deze in een nieuw proces en erkent de installatie. Er wordt geen sleutel gekopieerd vanuit de browser.

Toegang tot eigenaar opslaan en verifiëren
flashdata auth finish --wait --timeout 10m --json --non-interactive
Controleer dan vanuit een nieuwe terminal · dezelfde OS gebruiker en profiel
flashdata auth status --json --non-interactive
flashdata account balance --json --non-interactive

Bevestig de eigenaar en het saldo

In auth status, controleer de beoogde accountId en verleende scopes, plus de onderstaande velden. Lees het verse saldo apart; toekomstige aanvragen besteden de gedeelde credits van de eigenaar. Niet-gebruikte tijdelijke kredieten worden niet overgedragen. Een nieuwe account volgt op de normale aanmeldingsmogelijkheid; het claimen voegt geen extra inschrijvingssubsidie toe.

De rekening wordt gewijzigd. Kies voor een nieuwe taak onder de eigenaar een nieuwe ID. Het hergebruiken van een proefrun ID geeft run_account_mismatch terug zonder een andere query te sturen; die run wordt niet overgedragen aan de eigenaar.

Verwachte velden · responsfragment
{
  "ok": true,
  "data": {
    "accessVerified": true,
    "identity": {
      "identity": {
        "accountType": "owned",
        "access": "ready",
        "installed": true,
        "recurringAllowed": true
      }
    }
  }
}

Productenrechten kiezen

De HTTP-machtigingscatalogus maakt onderscheid tussen trialEligible en ownerAllowed. Vraag vóór de eerste registratie alleen de bronnen aan die je taak nodig heeft. requestedScopes bevat de aangevraagde machtigingen; scopes geeft de huidige toegang van de sleutel aan. Nieuwe producten vereisen expliciete toestemming.

Goedkeuring geeft toegang tot het gedeelde saldo van de eigenaar, inclusief gekochte credits. Bronbeperkingen stellen geen uitgavenlimiet per agent in. MCP OAuth is een aparte verbinding en koppelt dit CLI-profiel niet aan het account.

Alleen YouTube Download nodig?

Gebruik een eigenaarsleutel met youtube_download-permissie, importeer het en configureer vervolgens de bestemmingsopslag. Download gebruikt geen tijdelijke proefpunten.

CLI 1.2.1 vereist nog steeds een in aanmerking komende bron voor init. Voor het alleen aan boord downloaden voordat u zich aanmeldt, gebruik de HTTP claimstroom in auth.md. Voeg geen niet-gerelateerde trial bron toe om die client beperking te omzeilen.

Een gestopte stroom hervatten

Wat stopteVolgende actie
RegisterVoor 429, wacht op Retry-After. Voor een verloren respons, probeer init met hetzelfde profiel, bewijs en exacte invoer. Bestaand stand houden; niet overstappen op IP of een vervangende proef starten.
ZoekenControleer trial-search hieronder. Een timeout bewijst niet dat er geen werk is aangenomen. Verander de uitvoerings-ID niet om een nieuwe poging af te dwingen.
ClaimkoppelingAls de link verlopen is, maar de proef geldig is, maak dan een nieuwe link in hetzelfde profiel als de eigenaar klaar is. Controleer de ingelogde eigenaar vóór goedkeuring.
HandoffNa goedkeuring, opnieuw draaien auth finish in het oorspronkelijke profiel binnen 24 uren. In afwachting van de goedkeuring vereist een onderbroken wachttijd of een verloren ontvangstbevestiging geen nieuwe registratie.
Verlopen / verloren toestandVoor een verlopen proef of overdracht, of een verloren privé-staat directory, gebruik eigenaar-goedgekeurde herverbinding of importeer een eigenaar sleutel.
Controleer de opgeslagen zoekopdracht · geen nieuwe zoekopdracht
flashdata runs show trial-search --json --non-interactive