Langkau ke kandungan
MS
Dapatkan kunci API
Semak dokumentasi

Mula di sini

Percubaan ejen dan pemautan akaun

Coba pencarian Google sebelum signup, kemudian sambungkan akun pemilik untuk tetap menggunakan profil CLI yang sama.

Pada halaman ini

1. Periksa akses yang ada

Kau menjalankan cek gratis ini di lingkungan agenmu. data.accessVerified adalah true dan Google Search diizinkan, gunakan kembali akses tersebut dan lewati langkah 3. Dengan tanpa profil yang disimpan, terus melangkah 2. Melanjutkan akses tertunda atau diblokir menggunakan bagian pemulihan di bawah.

Periksa profil ini
flashdata auth status --json --non-interactive

Waluke profile yang sama

Berkolaboring access melaporkan data.accessVerified: true, access: ready di data.identity.identity, dan google_search di data.identity.permittedSources.

Perintah-perintah ini menggunakan profil default dan bekerja dalam Bash atau PowerShell. Untuk profil atau direktori keadaan langganan yang sudah ada, tambahkan --profile yang sama NAMA dan --state-dir ABSOLUTE_PATH ke setiap perintah, termasuk yang ada di terminal segar.

FLASHDATA_API_KEY mengatasi kunci yang disimpan. Biarkan pemboleh ubah ini tidak ditetapkan apabila menguji percubaan dan penyerahan bukti kelayakan profil ini. Gunakan pengguna OS yang sama dan kekalkan direktori keadaan peribadi; direktori ini menyimpan bukti kelayakan, bukti pendaftaran dan sejarah pelaksanaan.

Periksa credentialProtection di auth status. Windows menggunakan DPAPI, macOS menggunakan Keychain, dan Linux tanpa kepala mungkin menggunakan berkas kredensial yang hanya dimiliki. Toko OS yang tersedia dapat diperlukan dengan --credential-store os.

Sebaliknya menggunakan kunci pemilik yang ada

Orang di terminal dapat mengimpor kunci melalui prompt tersembunyi di bawah dan melewatkan pendaftaran pengadilan dan mengklaim. Agen-agen zegoza harus memasoknya di stdin dengan --api-key-stdin --non-interactive dari toko rahasia mereka; tidak pernah menempatkan kunci dalam argumen atau obrolan.

Jika profil sudah memegang akses yang berbeda, tinjaulah sebelum menggunakan auth login --replace. Mengimpor kunci lain bukanlah tuntutan. MCP OAuth juga merupakan sambungan host yang terpisah.

Prompt kunci tersembunyi · terminal manusia
flashdata auth login
flashdata auth status --json --non-interactive

2. Mulailah satu pengadilan yang memenuhi syarat

Jalur discover pertama. Periksa data.onboardingAvailable dan uang saku di data.onboarding.trial. Jika onboarding tersedia, jalankan init sekali untuk Google Search. Server keabsahan pemeriksaan kelayakan; CLI menyimpan kunci sementara tanpa penandatanganan pembukaan atau mengajukan pertanyaan.

Periksa ketersediaan (dalam bahasa Inggris) · gratis
flashdata discover --json --non-interactive
Mulakan akses sementara
flashdata init --name "Research assistant" --scopes google_search --json --non-interactive

Periksa penerimaan pendaftaran

Expect ok: true, data.status: trial dan google_search dalam data.connection.scopes. ¡data.connection.trialExpiresAt dan data.startingAllowanceCredits. Kunci disimpan secara lokal, tidak dicetak. data.currentBalanceAvailable adalah false, jalankan ulang pemeriksaan saldo bebas sebelum query.

Jika setup sudah dibuat akses, gunakan kembali. Ke label pendaftaran pertama agen, tambahkan --client codex --audience coding OR atau ORANG --client openclaw --audience personal. Simpan kembali masukan yang tepat pada retry; label tidak memberikan izin.

Kesusilaan dan batas - batas percobaan

Request equivalensi permintaan berbagi saldo kredit awal yang sama; mereka tidak tersisa permintaan atau kuota independen. Sumber-hanya pemilik seperti YouTube Download tidak dapat menghabiskan kredit percobaan.

BatasiApa yang harus diperiksa
Penghargaan / KedaluwarsaNilai bawaan saat ini: Nilai kredit 1 untuk jam 72. Temuan Bacaan untuk hibah dan seumur hidup; penerimaan tersebut memberikan sumber-sumber yang kadaluarsa dan diberikan.
Pendaftaran3 pendaftaran per IP per 24 Jam kerja, dibagikan oleh pengguna IP itu. Cadangan global mungkin juga menghentikan pendaftaran baru.
KonkurrensiTetap uji coba pekerjaan berurutan: satu item per kelompok dan satu pekerjaan tertunda. Periksa batas yang dikembalikan sebelum menyerahkan lebih banyak.

3. Cuba satu pencarian

Pratonton pertama. Persyaratan data.estimateAvailableQ, harga google_search yang tersedia dalam data.estimate.prices, dan availableCredits yang meliputi estimatedCredits. Berhenti jika cek gagal. Preview bebas; perintah berikutnya mengirimkan satu pencarian.

Periksa keseimbangan dan biaya · tidak ada pertanyaan
flashdata account balance --json --non-interactive
flashdata search "battery recycling" --num 5 --dry-run --json --non-interactive
Satu pencarian · sampai lima hasil
flashdata search "battery recycling" --num 5 --run-id trial-search --json --non-interactive

Semak hasil

ok: true dan data.status: done. Type, link dan snippet dari data.results[].organic, dan muatan dari data.usage.credits. Hasil organik yang kosong adalah valid. Sebelum mengklaim, mengulangi tugas yang tepat ini dengan trial-search mengembalikan hasil yang disimpannya. Tetap menjaga profil dan negara, dan mempertahankan setiap hasil persidangan yang Anda butuhkan.

Periksa sisa keseimbangan · bebas
flashdata account balance --json --non-interactive

4. Simpan akses ke akun pemilik

Tuntutan sebelum persidangan berakhir jika Anda ingin terus atau berulang digunakan. Ketika pemilik sudah siap, jalankan ini dalam profil asli. Kongsi hanya data.claimUrl dan data.confirmationCode dengan mereka; data.expiresAt memberikan batas waktu.

link terakhir 15 menit, atau sampai pengadilan berakhir jika lebih cepat. Mewujudkan link tidak menyetujui akses atau kredit pembelian.

\"Membuat link klaim ketika pemilik sudah siap\"
flashdata auth claim --json --non-interactive

Aquirove in the browser

  1. Pemiliknya membuka link dan tanda masuk, atau menciptakan akun baru dan memverifikasi email. Sebuah pendaftaran baru melanjutkan klaim setelah verifikasi.
  2. Cek rekening yang ditunjukkan di halaman klaim. Untuk pemilik yang berbeda atau baru, gunakan sesi peramban yang terpisah. Akun yang ditanda-tangani adalah akun yang akan membayar untuk permintaan nanti.
  3. Masukkan kode delapan digit pada halaman tersebut, meninjau kembali izin produk dan akses share-balance, kemudian disetujui. Pemiliknya menangani pendaftaran, penerimaan hukum, pengesahan email dan persetujuan.

Finish di terminal asli

Setelah persetujuan, jalankan finish di profil asli dalam 24 jam. CLI menyimpan kunci pemilik, memverifikasinya dalam proses segar dan mengakui pemasangan. Tak ada kunci yang disalin dari peramban.

Simpan dan verifikasi akses pemilik
flashdata auth finish --wait --timeout 10m --json --non-interactive
Kemudian, periksa dari terminal segar · sama OS pengguna dan profil
flashdata auth status --json --non-interactive
flashdata account balance --json --non-interactive

Konfirmasikan pemilik dan keseimbangan

Di auth status, verifikasi accountId yang dimaksudkan dan lingkup yang diberikan, ditambah bidang di bawah. FOGT membaca saldo segar secara terpisah; permintaan masa depan menghabiskan kredit bersama pemilik. Kredit sementara yang tidak digunakan tidak dipindahkan. Akun baru yang sesuai dengan kewajiban pendaftaran normal; mengklaim tidak menambahkan hibah tambahan.

Klaim klaim mengubah rekening yang ditagih. Untuk tugas baru di bawah pemilik, pilih ID baru. Mengecoh kembali sebuah uji coba menjalankan ID mengembalikan run_account_mismatch tanpa mengajukan pertanyaan lain; itu tidak mentransfer yang berjalan ke pemilik.

Medan - bidang yang diharapkan · kutipan tanggapan
{
  "ok": true,
  "data": {
    "accessVerified": true,
    "identity": {
      "identity": {
        "accountType": "owned",
        "access": "ready",
        "installed": true,
        "recurringAllowed": true
      }
    }
  }
}

Pilih izin produk

Katalog kebenaran HTTP membezakan trialEligible daripada ownerAllowed. Sebelum pendaftaran pertama, minta hanya sumber yang diperlukan untuk tugas anda. requestedScopes mengandungi kebenaran yang diminta; scopes menunjukkan akses semasa kunci. Produk baharu memerlukan pemberian kebenaran yang jelas.

Kelulusan membenarkan penggunaan baki bersama pemilik, termasuk kredit yang dibeli. Sekatan sumber tidak menetapkan had perbelanjaan bagi setiap ejen. MCP OAuth ialah sambungan berasingan dan tidak memautkan profil CLI ini kepada akaun.

Hanya perlu YouTube Download?

Xifac menggunakan kunci pemilik dengan izin youtube_download, mengimpornya, kemudian mengkonfigurasi penyimpanan tujuan. Download tidak menggunakan kredit pengadilan sementara.

CLI 1.2.1 masih membutuhkan sumber yang dapat diisi-ujian untuk init. Untuk Download-only onboarding sebelum signup, gunakan aliran klaim HTTP dalam auth.md. Jangan menambahkan sumber percobaan yang tidak berhubungan hanya untuk memotong pembatasan klien itu.

Melanjutkan aliran berhenti

Apa yang berhentiTindakan berikutnya
DaftarUntuk 429, tunggu Retry-After. Untuk respon yang hilang, coba lagi init dengan profil, bukti yang sama dan masukan yang tepat. ¡Jaga keadaan yang sudah ada; jangan beralih IP atau memulai sidang pengganti.
CariPeriksa trial-search dibawah. Sebuah tenggat waktu tidak membuktikan bahwa tidak ada pekerjaan yang diterima; jangan ubah lari ID untuk memaksa mencoba lagi.
Klaim linkJika link tersebut kadaluarsa tetapi persidangannya valid, buat link segar di profil yang sama ketika pemilik sudah siap. Periksa pemilik yang ditandatangani sebelum persetujuan.
AYAHSetelah disetujui, jalankan ulang auth finish dalam profil asli dalam 24 jam. Penundaan persetujuan, penantian yang terganggu atau pengakuan yang hilang tidak memerlukan pendaftaran baru.
Luput / keadaan hilangUntuk pengadilan atau penyerahan yang telah luput, atau direktori negara swasta yang hilang, gunakan rekoneksi yang disetujui oleh pemilik atau impor kunci pemilik.
Periksalah pencarian tersimpan · tidak ada pertanyaan baru
flashdata runs show trial-search --json --non-interactive