Langkau ke kandungan
MS
Dapatkan kunci API
Semak dokumentasi

Mula di sini

Soalan lazim dan penyelesaian masalah

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.

Akun gratis dibaca
flashdata --version
flashdata doctor --offline
flashdata auth status --json

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.

Memerlukan barang yang bisa dieksekusi
command -v flashdata
flashdata --version
flashdata doctor --offline

401 / 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.

  1. 401Periksa kunci yang sudah kadaluarsa, dicabut atau salah dikonfigurasi. 403Bandingkan sumber yang diminta dengan ruang lingkup identitas.
  2. ¡REST dan SDK menggunakan X-API-Key. Token MCP OAuth tidak dapat menggantikan kunci API. Untuk akses sementara, gunakan klaim pemulihan di bawah ini.
Kepingan dan sahkan kunci pemilik tersimpan
flashdata auth login --replace
flashdata auth status --json

Klaim 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.

Sudah selesai dan sahkan
flashdata auth finish --wait --timeout 10m
flashdata auth status --json

402: 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.

Akun gratis dibaca
flashdata account balance
flashdata account pricing --source google_search --request-count 1

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.

Merebut tanggapan · Bash / cURL / jq
# 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
)
Menginspeksi kapasitas akun
flashdata account limits

400 / 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.

Disahkan tanpa penyerahan yang dibayar
flashdata query --input request.json --mode async --dry-run --json

Job 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 errorTindakan berikutnya
pending / processingTunggu pada pekerjaan yang sama; jangan menyerahkannya lagi.
completedKutip dan simpan hasil yang ada.
failedPeriksa job.error sebelum menyerahkan pekerjaan yang dikoreksi.
404Periksa pekerjaan ID dan rekening pengiriman.
409Hasil belum siap. jajak pendapat tetap sama.
410Ketersimpanan JSON berakhir setelah jam 24. Gunakan salinan tersimpan Anda; media yang disampaikan memiliki retensi penyimpanan sendiri.
Periksalah pekerjaan yang disimpan · Bash / jq
# 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
)
Masih berjalan · menggunakan JOB_ID yang dikembalikan
flashdata jobs wait JOB_ID
Selesai · gunakan nama berkas keluaran baru
flashdata jobs result JOB_ID --output recovered-result.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.

Periksa nilai · pertama menggantikan RUN_ID
flashdata runs show RUN_ID
Pemulihan dikonfirmasi menerima pekerjaan
flashdata runs recover RUN_ID

CLI 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.

Periksalah lari yang asli
flashdata runs show RUN_ID

Pencarian kosong, hilang kapsi atau unduhan tak terbaca

Perintah-perintah ini hanya membaca berkas hasil lokal, bukan amplop CLI's stdout.

MCP 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.

Konfigurasi pemeriksaan yogon
codex mcp list
Hanya ketika login OAuth diperlukan
codex mcp login flashdata --scopes mcp:research

Keterampilan 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.

Periksa standar CLI skill bundle
flashdata skills verify --agent codex

Pertanyaan 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.

Rekod semakan akses CLI percuma · Bash
flashdata auth status --json 2> diagnostic.json
Pengidentifikasi galat · Bash / jq
# 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.json
Laporan dukungan Sodium
Waktu 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: