Jelajahi dokumentasi
Mulai
Periksa aksesmu, perbaiki permintaan yang gagal atau temukan jawaban tentang penggunaan FlashData.
Di halaman ini
Mulai dengan pemeriksaan akses bebas
Jalankan pemeriksaan di mana tugas gagal. Gunakan kredensial yang ada; perintah ini tidak mengirimkan sebuah permintaan.
Gunakan disimpan Anda CLI Akses. Untuk profil bernama, tambahkan --profile NAMA ke setiap perintah. Baca ini jangan menghabiskan kredit query.
flashdata --version
flashdata doctor --offline
flashdata auth status --jsonGunakan tugas yang ada FLASHDATA_API_KEY di terminal yang sama, kontainer atau pekerjaan yang dijadwalkan. Membutuhkan cURL 7.76 +.
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)Gunakan tugas yang ada FLASHDATA_API_KEY di terminal yang sama, kontainer atau pekerjaan yang dijadwalkan.
& {
$ErrorActionPreference = 'Stop'
if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
throw 'Set FLASHDATA_API_KEY first'
}
$flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
$flashdataBase = 'https://api.flashdata.dev/v2'
$flashdataUri = "$flashdataBase/api-access/identity"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}Apa yang harus diperiksa
Identitas harus memiliki access: ready dan termasuk sumber Anda dalam lingkup. Dalam CLI JSON, identitas tersebut berada di data.identity.identity; juga memerlukan data.accessVerified: true. Perintah sukses dengan accessVerified: false belum diverifikasi akses.
Untuk profil CLI bernama, tambahkan --profile NAMA ke setiap perintah di bawah ini. Pertahankan pengguna asli --state-dir dan OS. FLASHDATA_API_KEY overrides yang disimpan CLI kunci; SDK dan MCP host menggunakan konfigurasi kredensial mereka sendiri.
Cari dan perbaiki masalah
Buka gejala yang cocok dengan kesalahanmu. Gunakan IDs dan tanda terima dari tugas asli.
Perintah tak ditemukan atau profil hilang
Tak ada executable: pasang rilis untuk OS/CPU Anda dan tambahkan direktori ke PATH. Hilang profil: gunakan asli pengguna OS dan direktori state. Periksa di dalam penjadwalan atau kontainer, juga.
command -v flashdata
flashdata --version
flashdata doctor --offlineGet-Command flashdata
flashdata --version
flashdata doctor --offline401 / 403: kunci, scope atau expiry
Untuk mengganti kunci pemilik yang disimpan, tempelkan kunci yang disetujui ke prompt tersembunyi. Jika FLASHDATA_API_KEY diset, perbarui rahasia tersebut dalam waktu-jalan; menyimpan kunci CLI lain tidak akan menimpa itu.
- 401: periksa untuk kadaluarsa, dicabut atau tidak benar dikonfigurasi kunci. 403: bandingkan sumber yang diminta dengan scope identitas.
- REST dan SDK menggunakan X-API-Key. An MCP OAuth token tidak dapat menggantikan sebuah API kunci. Untuk akses sementara, gunakan pemulihan klaim di bawah ini.
flashdata auth login --replace
flashdata auth status --jsonKlaim disetujui, tapi agen masih memiliki akses percobaan
Selesai handoff dalam sama CLI profil yang menciptakan klaim. Pemilik melengkapi pendaftaran, verifikasi email dan persetujuan dalam peramban; CLI menerima kredensial tersebut.
flashdata auth finish --wait --timeout 10m
flashdata auth status --jsonMeminta link baru untuk percobaan yang ada, biarkan pemilik menyetujui, kemudian jalankan auth finish. Jangan jalankan init lagi.
flashdata auth claim402: kredit tidak mencukupi
Bandingkan availableCredits dengan harga saat ini untuk sumber Anda. Klaim percobaan kelelahan untuk menggunakan keseimbangan pemilik, atau biarkan pemilik ulasan Billing sebelum mencoba kembali.
Gunakan disimpan Anda CLI Akses. Untuk profil bernama, tambahkan --profile NAMA ke setiap perintah. Baca ini jangan menghabiskan kredit query.
flashdata account balance
flashdata account pricing --source google_search --request-count 1Gunakan tugas yang ada FLASHDATA_API_KEY di terminal yang sama, kontainer atau pekerjaan yang dijadwalkan. Membutuhkan cURL 7.76 +.
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
'https://api.flashdata.dev/v2/api-access/balance' || exit
printf '\n'
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
'https://api.flashdata.dev/v2/api-access/pricing?source=google_search&request_count=1' || exit
printf '\n'
)Gunakan tugas yang ada FLASHDATA_API_KEY di terminal yang sama, kontainer atau pekerjaan yang dijadwalkan.
& {
$ErrorActionPreference = 'Stop'
if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
throw 'Set FLASHDATA_API_KEY first'
}
$flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
$flashdataBase = 'https://api.flashdata.dev/v2'
$flashdataUri = "$flashdataBase/api-access/balance"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
$flashdataUri = "$flashdataBase/api-access/pricing?source=google_search&request_count=1"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}429: tunggu sebelum mencoba kembali
Baca Retry-After pada respon gagal: detik atau tanggal HTTP. Tunggu sampai saat itu dan mengurangi konkurensi. Registrasi pengadilan memungkinkan tiga registrasi per IP per 24-hour window; gunakan kembali profil asli dan bukti pendaftaran.
Pembacaan gratis ini menunjukkan header, status, dan tubuh. Gunakan Retry-After dari operasi yang gagal; query, registrasi dan akuntansi dapat berbeda.
# Bash + cURL + jq. This is a free account read.
(
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
curl --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--dump-header diagnostic-headers.txt --output diagnostic.json \
--write-out '%{http_code}\n' \
'https://api.flashdata.dev/v2/api-access/identity' > diagnostic-status.txt || exit
printf 'HTTP '; cat diagnostic-status.txt
awk 'tolower($1) == "retry-after:" {
$1=""; sub(/^ /, ""); sub(/\r$/, ""); print "Retry-After: " $0
}' diagnostic-headers.txt
if jq -e 'type == "object"' diagnostic.json >/dev/null 2>&1; then
jq '{access, scopes, status, code, requestId}
| with_entries(select(.value != null))' diagnostic.json
else
printf 'Non-JSON response saved in diagnostic.json; check the HTTP status.\n'
fi
)flashdata account limits400 / 422: menolak masukan atau pemrosesan gagal
Baca kode, detail dan fieldErrors dari kesalahan HTTP. Benar tubuh permintaan, menyimpannya sebagai request.json, kemudian memvalidasikannya. Simpan kredensial penyimpanan Unduh dalam berkas masukan privat. Jika 422 berasal dari hasil pekerjaan yang ada, periksa job.error terlebih dahulu.
flashdata query --input request.json --mode async --dry-run --jsonPekerjaan tertunda, atau HTTP 200 dengan pekerjaan gagal
Baca pekerjaan dari submission.json, tanda terima async Anda yang tersimpan. HTTP 200 berarti pembacaan status berhasil; job.status adalah hasil tugasnya (data.status in CLI JSON). Untuk Batch, simpan entri relevan dari query sebagai submission.json.
| Keadaan atau galat | Aksi berikutnya |
|---|---|
| pending / processing | Tunggu pada pekerjaan yang sama; jangan mengirimkannya lagi. |
| completed | Ambil dan simpan hasil yang telah ada. |
| failed | Inspeksi job.error sebelum mengirimkan pekerjaan yang dikoreksi. |
| 404 | Periksa pekerjaan ID dan akun pengiriman. |
| 409 | Hasil belum siap. Tetap lakukan polling. |
| 410 | JSON Tersimpan habis setelah jam 24. Gunakan salinan tersimpan Anda; media yang dikirim memiliki penyimpanan sendiri. |
# Bash + jq. CLI receipts use remoteId; HTTP receipts use id.
(
set -e
JOB_ID=$(jq -er '.remoteId // .id' submission.json)
flashdata jobs get "$JOB_ID" --json
)flashdata jobs wait JOB_IDflashdata jobs result JOB_ID --output recovered-result.json# Bash + cURL + jq. Read the saved async submission receipt.
(
set -e
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
STATUS_URL=$(jq -er '(.submission // .).links[]
| select(.rel == "self") | .href' submission.json)
curl --fail-with-body --silent --show-error --max-time 30 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--header 'Accept: application/json' \
"$STATUS_URL" --output job.json
jq '.job | {id, status, error}' job.json
)Timeout / 5xx: apakah tugas diterima?
Periksa asli run dan History sebelum mencoba kembali POST. Menerima kembali pekerjaan yang diterima. Jika penerimaan tidak diketahui, pastikan ID dijalankan dan dukungan kontak; mengubah IDs dan menyerahkan kembali dapat menduplikasi biaya.
flashdata runs show RUN_IDflashdata runs recover RUN_IDCLI output_exists: berkas hasil sudah ada
Berkas CLI tidak menimpa berkas --output. Baca berkas yang sudah ada, atau pilih nama berkas keluaran baru saat menyimpan permintaan asli --run-id. Jangan ciptakan ID baru untuk melewati kesalahan ini.
flashdata runs show RUN_IDPencarian kosong, takarir keterangan atau download yang tak dapat dibaca
Perintah ini hanya membaca berkas hasil lokal, bukan CLI's stdout amplop.
Jika status selesai dan organik kosong, filter query longgarkan. Simpan hasil kosong dalam catatan tugas Anda.
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.jsonMetadata daftar kode bahasa, bukan apakah trek manual atau otomatis. Pilih bahasa terdaftar dan atur otomatis explicitly: true untuk otomatis, false untuk manual. Tak ada trek yang cocok berarti tak ada takarir bagi pemilihan itu; FlashData tidak menghasilkan pengganti.
jq '.results[0].transcriptLanguages' metadata.jsonBaca tanda terima delivery.json yang telah selesai. Unduh objek dengan dokumen destination- penyimpanan kredensial, lalu bandingkan ukurannya dan MD5 dengan tanda terima. file_url pribadi tidak menjadi publik setelah pengiriman.
jq '.results[0] | {file_url, file_size, md5}' delivery.jsonMCP alat yang hilang atau otentikasi kadaluwarsa
Periksa host yang menjalankan tugas. Server yang terdaftar menegaskan konfigurasi, bukan koneksi kerja. Jika koneksi OAuth yang dikonfigurasi memerlukan login, jalankan perintah login dan persetujuan peramban lengkap, kemudian segarkan daftar alat.
Buka /mcp dalam Codex CLI untuk memeriksa status koneksi dan alat-alat. Dalam aplikasi, periksa konfigurasi server dan mulai sesi baru setelah perubahan setup.
codex mcp listcodex mcp login flashdata --scopes mcp:researchopenclaw mcp doctor flashdata --probeopenclaw mcp login flashdata
openclaw mcp doctor flashdata --probeMasuk OAuth tidak memperbaiki sambungan kunci API-. Periksa kunci dalam lingkungan host dan hak sumbernya. Untuk stdio lokal, periksa paket MCP paket Node.js persyaratan dan restart host setelah memperbarui lingkungannya.
node --versionSkill terpasang tetapi agen tidak dapat menemukan atau menggunakannya
Periksa proyek yang sama, profil host dan lokasi instalasi, kemudian mulai sesi agen baru. CLI keterampilan tugas membutuhkan CLI; flashdatta -mcp membutuhkan koneksi MCP server. Memasang keterampilan tidak menghubungkan server atau memberikan ijin akun.
flashdata skills verify --agent codexflashdata skills verify --agent codex --skill flashdata-mcpopenclaw skills list --eligible
openclaw skills checkPertanyaan yang sering ditanyakan
Mendapatkan terhubung
Apa aku butuh agen AI?
Tidak. Gunakan HTTP API, Go/Python/TypeScript SDK, CLI atau konsol secara langsung. MCP dan keterampilan adalah pilihan tambahan bagi agen.
Antarmuka mana yang harus kupilih?
Gunakan SDK atau HTTP API di dalam aplikasi, CLI untuk tugas terminal, dan MCP untuk MCP-tuan rumah yang mampu. Keterampilan menyediakan instruksi baik untuk tugas CLI maupun perangkat MCP yang tersambung; mereka tidak mengganti otentikasi.
Dapatkah saya menggunakan kembali kredensial untuk tugas yang berulang?
Ya. Gunakan akses pemilik dan melestarikan profil CLI yang dilindungi sama, rahasia runtime atau koneksi MCP. Untuk API-key akses, periksa recurringAllowed: true. Host Anda atau penjadwalan menjalankan jadwal.
Apakah menghapus pengaturan lokal mencabut akses?
Tidak. Mengembalikan kunci API atau koneksi di konsol. Menghapus pengaturan lokal hanya menghapus salinan lokal tersebut.
Ujian dan kredit
Bisakah seorang agen mencoba FlashData sebelum mendaftar?
Ya, dengan akses sementara yang memenuhi syarat melalui CLI atau onboarding API. Gunakan kembali profil dan bukti registrasi yang sama. Penggunaan terus-menerus perlu diklaim atau pemilik yang ada kunci API.
Apakah mengklaim menambahkan test grant?
Klaiming sendiri tidak memberikan kredit percobaan tambahan. Permintaan Future menggunakan saldo akun pemilik; kredit sementara yang tidak digunakan tidak transfer. Sebuah akun baru dibuat mengikuti kebijakan normal kredit.
Berapa banyak permintaan yang bisa menutupi kreditku?
Periksa saldo akun dan harga sumber. Permintaan tergantung pada sumber, dan gabungan tugas sumber berbagi satu keseimbangan. YouTube Download bernilai oleh byte yang diunduh, bukan jumlah permintaan tetap.
Sumber dan hasil
Mengapa agenku mencari tapi tidak mengunduhnya?
Unduh membutuhkan akses pemilik, youtube_download izin dan penyimpanan tujuan. Percobaan sementara dan mcp:research OAuth tidak termasuk Unduhan. Pemilik yang berwenang API kunci dapat menggunakannya melalui CLI, HTTP atau MCP.
Apakah Google Search kembali halaman web penuh?
Ini mengembalikan hasil pencarian dan kutipan. Aplikasi atau agen Anda membaca URLs terpilih.
Apakah FlashData menghasilkan video ringkasan atau takarsi?
Ini mengambil metadata dan keterangan yang ada. Ini tidak menghasilkan takarir yang hilang; model Anda menulis ringkasan dari hasil yang tersedia.
Masih terjebak? Kirim laporan minimal
Simpan HTTP kesalahan badan atau CLI JSON kesalahan dari stderr sebagai diagnostic.json. Ekstrak pengidentifikasi hanya setelah perintah gagal. Simpan kunci, teks kueri pribadi dan ditandatangani URLs keluar dari laporan. Untuk non-JSON Respon, laporkan HTTP status dari diagnostic-status.txt.
flashdata auth status --json 2> diagnostic.json# A saved HTTP error or CLI --json error; local files only.
date -u '+%Y-%m-%dT%H:%M:%SZ'
jq '(.error // .) as $e | {
status: ($e.httpStatus // $e.status),
code: $e.code,
requestId: $e.requestId,
runId: (.runId // $e.runId),
jobId: $e.remoteId,
retryAfter: $e.retryAfter
} | with_entries(select(.value != null))' diagnostic.jsonWaktu UTC:
Klien + versi:
Source + stage (auth / submit / poll / fetch):
HTTP status + kode error:
Permintaan ID / job ID / run ID:
Hasil submission: diterima / ditolak / tidak diketahui
Diduga vs hasil aktual: