Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Mulai

FAQ dan pemecahan masalah

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.

Rekening bebas dibaca
flashdata --version
flashdata doctor --offline
flashdata auth status --json

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.

Temukan executable
command -v flashdata
flashdata --version
flashdata doctor --offline

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

  1. 401: periksa untuk kadaluarsa, dicabut atau tidak benar dikonfigurasi kunci. 403: bandingkan sumber yang diminta dengan scope identitas.
  2. 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.
Ganti dan verifikasi kunci pemilik yang disimpan
flashdata auth login --replace
flashdata auth status --json

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

Selesai dan verifikasi
flashdata auth finish --wait --timeout 10m
flashdata auth status --json

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

Rekening bebas dibaca
flashdata account balance
flashdata account pricing --source google_search --request-count 1

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.

Menangkap respon 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
)
Inspeksi kapasitas akun
flashdata account limits

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

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

Pekerjaan 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 galatAksi berikutnya
pending / processingTunggu pada pekerjaan yang sama; jangan mengirimkannya lagi.
completedAmbil dan simpan hasil yang telah ada.
failedInspeksi job.error sebelum mengirimkan pekerjaan yang dikoreksi.
404Periksa pekerjaan ID dan akun pengiriman.
409Hasil belum siap. Tetap lakukan polling.
410JSON Tersimpan habis setelah jam 24. Gunakan salinan tersimpan Anda; media yang dikirim memiliki penyimpanan sendiri.
Inspeksi tugas 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! Gunakan yang kembali JOB_ID
flashdata jobs wait JOB_ID
Selesai memakai nama berkas keluaran baru
flashdata jobs result JOB_ID --output recovered-result.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.

Inspeksi terlebih dahulu RUN_ID
flashdata runs show RUN_ID
Recover dikonfirmasi menerima pekerjaan
flashdata runs recover RUN_ID

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

Inspeksi run asli
flashdata runs show RUN_ID

Pencarian kosong, takarir keterangan atau download yang tak dapat dibaca

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

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

Periksa konfigurasi
codex mcp list
Hanya ketika OAuth login dibutuhkan
codex mcp login flashdata --scopes mcp:research

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

Periksa bundel keterampilan CLI baku
flashdata skills verify --agent codex

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

Menangkap gratis CLI pemeriksaan akses Bash
flashdata auth status --json 2> diagnostic.json
Ekstrak identifikasi kesalahan 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
Waktu 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: