Semak dokumentasi
Mula di sini
Periksa akses Anda, perbaiki permintaan yang gagal atau cari jawaban tentang penggunaan FlashData.
Pada halaman ini
Kita akan mulai dengan cek akses gratis
Jalankan pemeriksaan di mana tugas itu gagal. Guna kelayakannya yang sudah ada; perintah ini tidak mengajukan pertanyaan.
Gunakan CLI yang disimpan. Untuk profil bernama, tambahkan --profile NAMA ke setiap perintah. Bacaan ini tidak menghabiskan kredit pertanyaan.
flashdata --version
flashdata doctor --offline
flashdata auth status --jsonUse the task's sudah ada FLASHDATA_API_KEY di terminal yang sama, kontainer atau pekerjaan terjadwal. Kemudi 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'
)Use the task's sudah ada FLASHDATA_API_KEY di terminal yang sama, kontainer atau pekerjaan terjadwal.
& {
$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
Identitinya harus memiliki access: ready dan termasuk sumber Anda dalam lingkup. Dalam CLI JSON, identitas berada di data.identity.identity; juga membutuhkan data.accessVerified: true. Perintah sukses dengan accessVerified: false belum diverifikasi akses.
Untuk profil CLI bernama, tambahkan --profile NAMA ke setiap perintah di bawah. ¡Jaga pengguna --state-dir dan OS asli. FLASHDATA_API_KEY Membatalkan penyelamatan CLI Kuncinya adalah: Host SDK dan MCP menggunakan konfigurasi kredensial mereka sendiri.
Cari dan perbaiki masalahnya
Buka gejala yang cocok dengan kesalahanmu. Guna IDs Penerimaan dan penerimaan dari tugas aslinya.
Perintah Ufine tidak ditemukan atau profil hilang
Tak ada executable: pasang rilis untuk OS/CPU anda dan tambahkan direktorinya ke PATH. Profil someless: gunakan direktori pengguna dan keadaan OS asli. Periksa di dalam penjadwal atau kontainer juga.
command -v flashdata
flashdata --version
flashdata doctor --offlineGet-Command flashdata
flashdata --version
flashdata doctor --offline401 / 403Kunci, skop atau ekspiri
Untuk mengganti kunci pemilik tersimpan, tampal kunci yang disetujui ke dalam prompt tersembunyi. FLASHDATA_API_KEY telah ditetapkan, update rahasia itu dalam waktu jalan sebagai gantinya; menyimpan kunci CLI lain tidak akan menimpanya.
- 401Periksa kunci yang sudah kadaluarsa, dicabut atau salah dikonfigurasi. 403Bandingkan sumber yang diminta dengan ruang lingkup identitas.
- ¡REST dan SDK menggunakan X-API-Key. Token MCP OAuth tidak dapat menggantikan kunci API. Untuk akses sementara, gunakan klaim pemulihan di bawah ini.
flashdata auth login --replace
flashdata auth status --jsonKlaim klaim disetujui, tapi agen masih memiliki akses pengadilan
Setelah menyelesaikan handoff dalam profil CLI yang sama yang menciptakan klaim. Pemiliknya melengkapi pendaftaran, pengesahan email dan persetujuan di dalam peramban; CLI menerima kredensial.
flashdata auth finish --wait --timeout 10m
flashdata auth status --jsonPermintaan link segar untuk sidang yang ada, biarkan pemilik menyetujui, kemudian menjalankan auth finish. Jangan jalankan init lagi.
flashdata auth claim402: kredit tidak mencukupi
Bandingkan availableCredits dengan harga saat ini untuk sumber anda. Klaim klaim pengadilan yang kelelahan untuk menggunakan saldo pemilik, atau membiarkan pemilik meninjau Billing sebelum mencoba lagi.
Gunakan CLI yang disimpan. Untuk profil bernama, tambahkan --profile NAMA ke setiap perintah. Bacaan ini tidak menghabiskan kredit pertanyaan.
flashdata account balance
flashdata account pricing --source google_search --request-count 1Use the task's sudah ada FLASHDATA_API_KEY di terminal yang sama, kontainer atau pekerjaan terjadwal. Kemudi 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'
)Use the task's sudah ada FLASHDATA_API_KEY di terminal yang sama, kontainer atau pekerjaan terjadwal.
& {
$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
}429Tunggu sebelum mencoba lagi
Kemuliaan baca Retry-After pada respon gagal: detik atau tanggal HTTP. Tunggu sampai saat itu dan kurangi konkurensi. Pendaftaran uji coba uji coba mengizinkan tiga pendaftaran per IP per 24-jam jendela; menggunakan kembali profil dan bukti pendaftaran asli.
Bacaan gratis ini menunjukkan menyimpan header, status, dan tubuh. Use Retry-After dari operasi yang gagal; kueri, pendaftaran dan batas baca akun 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: gagal input atau pemrosesan ditolak
Kode baca, detail dan fieldErrors dari HTTP error. Membetulkan badan permintaan, menyimpannya sebagai request.json, kemudian memvalidasinya. KELUARAN Muaturun kelayakan penyimpanan dalam sebuah berkas masukan pribadi. if 422 berasal dari hasil pekerjaan yang sudah ada, inspeksi job.error terlebih dahulu.
flashdata query --input request.json --mode async --dry-run --jsonJob tertunda, atau HTTP 200 dengan pekerjaan yang gagal
Bacalah pekerjaan dari submission.json, penerimaanmu yang telah disimpan. HTTP 200 Woadon berarti pembacaan status berhasil; job.status (Y: i) (Y: i) adalah hasil tugas (data.status dalam CLI JSON). Untuk Batch, simpan masukan yang relevan dari kueri sebagai submission.json.
| Negara atau error | Tindakan berikutnya |
|---|---|
| pending / processing | Tunggu pada pekerjaan yang sama; jangan menyerahkannya lagi. |
| completed | Kutip dan simpan hasil yang ada. |
| failed | Periksa job.error sebelum menyerahkan pekerjaan yang dikoreksi. |
| 404 | Periksa pekerjaan ID dan rekening pengiriman. |
| 409 | Hasil belum siap. jajak pendapat tetap sama. |
| 410 | Ketersimpanan JSON berakhir setelah jam 24. Gunakan salinan tersimpan Anda; media yang disampaikan memiliki retensi 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
)Masa Kehabisan Masa Tamat / 5xx: Apakah tugas itu diterima?
Periksa jalankan asli dan History sebelum mencoba kembali POST. Pemulihan kembali pekerjaan yang diterima. Jika penerimaan tidak diketahui, jaga jangka ID dan dukungan kontak; mengubah IDs dan pengiriman ulang dapat menggandakan biaya.
flashdata runs show RUN_IDflashdata runs recover RUN_IDCLI output_exists): berkas hasil sudah ada
XACLI tidak menindih berkas --output. Í Baca berkas yang ada, atau pilih nama file keluaran baru sambil menjaga --run-id asli dan permintaan. Jangan ciptakan ID baru untuk melewati kesalahan ini.
flashdata runs show RUN_IDPencarian kosong, hilang kapsi atau unduhan tak terbaca
Perintah-perintah ini hanya membaca berkas hasil lokal, bukan amplop CLI's stdout.
Jika status dilakukan dan organik kosong, melonggarkan filter kueri. Simpan hasil kosong dalam catatan tugas Anda.
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.jsonKata metadata ode bahasa, tidak peduli apakah trek manual atau otomatis. Iafinger Pilih bahasa yang terdaftar dan set auto explicitly: true untuk otomatis, false untuk manual. Tak ada lagu yang cocok berarti tak ada keterangan untuk pemilihan itu; FlashData tidak menghasilkan pengganti.
jq '.results[0].transcriptLanguages' metadata.jsonMembaca penerimaan delivery.json yang telah selesai. Knotownload objek dengan kredensial penyimpanan tujuan anda, kemudian bandingkan ukurannya dan MD5 dengan penerimaan. Sebuah file_url swasta tidak menjadi publik setelah pengiriman.
jq '.results[0] | {file_url, file_size, md5}' delivery.jsonMCP Alat-alat fengeus hilang atau autentikasi sudah kadaluarsa
Periksa tuan rumah yang menjalankan tugas. Server yang terdaftar mengkonfirmasi konfigurasi, bukan koneksi yang bekerja. Jika dikonfigurasikan koneksi OAuth yang di-konfigur memerlukan log masuk, jalankan perintah loginnya dan lengkapkan persetujuan peramban, maka segarkan kembali daftar alat.
Terbuka /mcp dalam Codex CLI untuk memeriksa status dan alat sambungan. Dalam aplikasi, periksa server yang telah dikonfigurasi dan mulai sesi baru setelah penetapan perubahan.
codex mcp listcodex mcp login flashdata --scopes mcp:researchopenclaw mcp doctor flashdata --probeopenclaw mcp login flashdata
openclaw mcp doctor flashdata --probeLogin OAuth tidak memperbaiki sambungan API-key. Periksa kunci di lingkungan tuan rumah dan izin sumbernya. Untuk stdio lokal, periksa persyaratan MCP paket Node.js dan start ulang host setelah memperbarui lingkungannya.
node --versionKeterampilan tidak dipasang tapi agen tidak dapat menemukan atau menggunakannya
Periksa proyek yang sama, profil host dan pasang lokasi, kemudian mulai sesi agen baru. Kemampuan tugas CLI membutuhkan CLI; flashdata-mcp membutuhkan server MCP yang terhubung. Instalasi sebuah keterampilan tidak menghubungkan server atau izin akun hibah.
flashdata skills verify --agent codexflashdata skills verify --agent codex --skill flashdata-mcpopenclaw skills list --eligible
openclaw skills checkPertanyaan yang sering diajukan
Menyambungkan akses
Apa aku perlu agen AI?
Tidak. Gunalah HTTP API, Go/Python/TypeScript SDK, CLI konsol atau konsol langsung. Ketrampilan dan kemampuan MCP adalah pilihan tambahan untuk agen.
Antarmuka mana yang harus kupilih?
Use an SDK atau HTTP API di dalam sebuah aplikasi, CLIQ untuk tugas terminal, dan MCP untuk sebuah MCP-capable host. Keterampilan menyediakan instruksi untuk tugas CLI atau alat MCP yang terhubung; mereka tidak menggantikan autentikasi.
BISAkah saya menggunakan lagi kelayakan untuk tugas yang berulang?
Ya. Ya. Use owner access dan menjaga profil CLI yang dilindungi sama, runtime secret atau MCP connection. Untuk akses API-key, periksa recurringAllowed: true. Waince, tuan rumah atau penjadwalmu yang menjalankan jadwal.
Apakah menghapus pengaturan lokal mencabut akses?
Tidak. Batalik ulang kunci API atau sambungan di konsol. Memadam pengaturan lokal hanya menghapus salinan lokal tersebut.
Cobaan dan Penghargaan
Apa agen bisa mencoba FlashData sebelum mendaftar?
Ya, dengan akses sementara yang dapat memenuhi syarat melalui CLI atau diboarding API. Gunakan kembali profil dan bukti pendaftaran yang sama. Melanjutkan penggunaan kebutuhan mengklaim atau pemilik kunci API yang sudah ada.
Apakah mengklaim menambahkan hibah percobaan lagi?
Klaim klaim itu sendiri tidak memberikan kredit percobaan tambahan. Permintaan permintaan permintaan masa depan menggunakan saldo rekening pemilik; kredit sementara yang tidak digunakan tidak dipindahkan. A akun yang baru dibuat mengikuti kebijakan signup-credit normal.
Berapa banyak permintaan yang bisa kuterima?
Periksa keseimbangan akun dan harga sumber. Permintaan tergantung pada sumber, dan tugas sumber campuran berbagi satu keseimbangan. YouTube Download diharga oleh byte yang diunduh, bukan jumlah permintaan tetap.
Sumber dan hasil
Kenapa agenku bisa mencari tapi tidak mengunduhnya?
download download membutuhkan akses pemilik, izin youtube_download dan penyimpanan tujuan. Uji coba sementara dan mcp:research OAuth tidak termasuk Download. Sebuah kunci API pemilik yang diberi wewenang dapat menggunakannya melalui CLI, HTTP atau MCP.
Apa Google Search kembali ke halaman web penuh?
Ia mengembalikan hasil pencarian dan kutipan. Anda aplikasi atau agen membaca URLs terpilih.
Apakah FlashData menghasilkan video summary atau kapsi?
Ini mengambil data meta dan gambar yang ada. Ia tidak menghasilkan keterangan yang hilang; model Anda menulis ringkasan dari hasil yang tersedia.
Masih terjebak? Kirim laporan minimal
Simpan badan ralat HTTP atau ralat JSON CLI daripada stderr sebagai diagnostic.json. Ekstrak pengecam hanya selepas arahan gagal. Jangan sertakan kunci, teks pertanyaan peribadi atau URL bertandatangan dalam laporan. Bagi respons bukan JSON, laporkan status HTTP daripada 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:
Versi Klien + klien:
Sumber + tahap (aut / tunduk / jajak pendapat / pengambilan):
Status HTTP + kode error:
Permintaan ID / pekerjaan ID / jalankan ID:
Hasil penyerahan: diterima / ditolak / tidak diketahui
Diharapkan hasil aktual vs: