Belgeleri incele
Başlarken
Erişiminizi kontrol edin, başarısız bir istek düzeltin veya FlashData kullanımı hakkında bir cevap bul.
Bu sayfada
Ücretsiz bir erişim kontrolü ile başlayın
Görevin başarısız olduğu kontrolini çalıştırın. Mevcut bilgilerini kullanın; bu komutlar bir sorgu göndermez.
CLI erişiminizi kullanın. Bir isim profili için, her komut için --profile NAME. Bu okumalar sorgu kredilerini harcamaz.
flashdata --version
flashdata doctor --offline
flashdata auth status --jsonGörevin mevcut FLASHDATA_API_KEY'yu aynı terminalde, konteyner veya planlanan işte kullanın. cURL 7.76+'yı gerektirir.
(
: "${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'
)Görevin mevcut FLASHDATA_API_KEY'yu aynı terminalde, konteyner veya planlanan işte kullanın.
& {
$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
}Ne kontrol etmek için
Kimlik access: ready'ye sahip olmalı ve kaynaklarınızı kapsamalıdır. CLI JSON, kimlik data.identity.identity'da; ayrıca data.accessVerified: true'u gerektirir. accessVerified: false ile başarılı bir komut doğrulanmadı.
CLI profili için, aşağıdaki her komut için --profile NAME. Orijinal --state-dir ve OS kullanıcısını tut. FLASHDATA_API_KEY overrides a save CLI key; SDKs ve MCP ev sahipliği kendi credential konfigürasyonunu kullanır.
Problemi Bul ve düzeltin
Hatanızı oynayan semptomu açın. IDs ve orijinal görevden gelen makblar kullanın.
Komut bulunamadı veya profil eksik
Hiçbir abartılamaz: OS/CPU için salıverin ve dizinini PATH'a ekleyin. Eksik profil: orijinal OS kullanıcı ve eyalet rehberi kullanın. Ayrıca programcı veya konteyner içinde kontrol edin.
command -v flashdata
flashdata --version
flashdata doctor --offlineGet-Command flashdata
flashdata --version
flashdata doctor --offline401 / 403: anahtar, kapsamı veya expiry
Kurtarılan bir sahibinin anahtarını değiştirmek için, onaylanmış anahtarı gizli bir şekilde yapıştırın. FLASHDATA_API_KEY ayarlandığında, o sırrı iş zamanında güncellemek yerine; başka bir CLI anahtarını tasarruf etmek bunu abartmayacaktır.
- 401: Geç kalmış, iptal edilmiş veya yanlış yapılandırılmış anahtar için kontrol edin. 403: talep edilen kaynağı kimlik kapsamıyla karşılaştırın.
- REST ve SDKs X-API-Key kullanıyor. Bir MCP OAuth token bir API anahtarı değiştiremez. Geçici erişim için, aşağıdaki iddia kurtarmasını kullanın.
flashdata auth login --replace
flashdata auth status --jsonOnaylandı, ancak ajan hala deneme erişimine sahiptir
İddiayı yaratan aynı CLI profilinde eloff bitirmek. Sahibi, tarayıcıda e-posta doğrulama ve onay alır; CLI haçlı alır.
flashdata auth finish --wait --timeout 10m
flashdata auth status --jsonMevcut deneme için taze bir bağlantı talep edin, sahibinin onay vermesine izin verin, sonra auth finish'u çalıştırın. init'u tekrar çalıştırmayın.
flashdata auth claim402: yetersiz kredi
availableCredits ile kaynağınız için mevcut fiyatla karşılaştırın. Sahibin dengesini kullanmak için tükenmiş bir deneme talep edin veya sahibi Billing'u yeniden denemeden önce gözden geçirmesine izin verin.
CLI erişiminizi kullanın. Bir isim profili için, her komut için --profile NAME. Bu okumalar sorgu kredilerini harcamaz.
flashdata account balance
flashdata account pricing --source google_search --request-count 1Görevin mevcut FLASHDATA_API_KEY'yu aynı terminalde, konteyner veya planlanan işte kullanın. cURL 7.76+'yı gerektirir.
(
: "${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'
)Görevin mevcut FLASHDATA_API_KEY'yu aynı terminalde, konteyner veya planlanan işte kullanın.
& {
$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: Yeniden denemeden önce bekleyin
Retry-After'u başarısız yanıt üzerinde okuyun: saniyeler veya bir HTTP tarihi. O zamana kadar bekleyin ve koncurrency azaltır. Deneme kaydı, 24-hour penceresi için IP'ye üç kayıt sağlar; orijinal profili ve kayıt kanıtı tekrarlayın.
Bu ücretsiz okuma, başlık, statü ve vücut tasarrufu gösterir. Retry-After'u başarısız olan operasyondan kullanın; sorgu, kayıt ve hesap hazır sınırları farklı olabilir.
# 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: girdileri veya işleme başarısızlıklarını reddetti
Kod, detay ve fieldErrors'dan HTTP hatası. Talep gövdesini düzeltin, request.json olarak tasarruf edin, sonra bunu doğrulayın. Özel bir giriş dosyasında depolama kimliklerini indirin. 422, mevcut bir işin sonucundan gelirse, job.error'u ilk olarak inceleyin.
flashdata query --input request.json --mode async --dry-run --jsonİş bekleyen veya HTTP 200 başarısız bir işle
İşi kayıtlı async makbuzunuz submission.json içinden okuyun. HTTP 200, durum okuma işleminin başarılı olduğunu belirtir; job.status görevin sonucudur (CLI JSON içinde data.status). Batch için queries içindeki ilgili girdiyi submission.json olarak kaydedin.
| Devlet veya hata | Sonraki eylem |
|---|---|
| pending / processing | Aynı işte bekleyin; tekrar göndermeyin. |
| completed | Fetch ve mevcut sonucu kurtar. |
| failed | İnspect job.error düzeltme çalışması sunmadan önce. |
| 404 | İş ID'u kontrol edin ve teslim hesabı. |
| 409 | Sonuçlar hazır değildir. Aynı işi ankete devam edin. |
| 410 | Stored JSON Sonunda sona ermişti 24 saatler. Kurtarılan kopyasını kullanın; teslim edilen medyanın kendi depolama tutma vardır. |
# 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: Görev kabul edildi mi?
Orijinal koşmak ve Inspect the original run and History Yeniden denemeden önce POST. Onaylanan bir işi yeniden keşfedin. Kabul bilinmiyorsa, koşmak ID ve iletişim desteği tut; IDs'u değiştirmek ve yeniden ortaya çıkarmak suçlamaları tekrarlayabilir.
flashdata runs show RUN_IDflashdata runs recover RUN_IDCLI output_exists: Sonuç dosya zaten var
CLI, --output dosyalarının üzerine yazmaz. Mevcut dosyayı okuyun veya özgün --run-id ve isteği koruyarak yeni çıktı dosyası adı seçin. Bu hatayı aşmak için yeni çalıştırma ID değeri üretmeyin.
flashdata runs show RUN_IDBoş arama, eksik komutlar veya hazırlanamaz indirme
Bu komutlar sadece yerel sonuç dosyaları okumuyor, CLI'nun stdout zarfı değil.
Durum yapılırsa ve organik boş ise, gevşek sorgu filtreleri. Görev kaydınızda boş sonucu tut.
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.jsonMetadata dil kodları listeliyor, bir iz manuel veya otomatik olup olmadığını değil. Listelenen bir dil seçin ve otomatik olarak explicitly: true'u otomatik olarak ayarlar, false manuel için. Hiçbir eşleştirme yolu bu seçim için hiçbir komut anlamına gelmez; FlashData bir yedek üretmiyor.
jq '.results[0].transcriptLanguages' metadata.jsonTamamlanan delivery.json makb. Hedefin öfke bildirimleriyle nesneyi indirin, sonra boyutunu ve MD5'yu makbul ile karşılaştırın. Özel bir file_url teslimattan sonra halka açık değildir.
jq '.results[0] | {file_url, file_size, md5}' delivery.jsonMCP araçları eksik veya doğrulama süresiz
Görevi çalıştırın ev sahibine göz atın. Listelenen bir sunucu yapılandırmayı doğrular, çalışma bağlantısı değil. Evlenen OAuth bağlantısı giriş gerektirirse, giriş komutunu çalıştırın ve tam tarayıcı onayını yapın, sonra araç listesini yenileyin.
Açık Açık Açık /mcp İçinde, Codex CLI Bağlantı durumunu ve araçlarını kontrol etmek. Uygulamada, yapılandırılmış sunucuyu kontrol edin ve kurulum değişikliklerden sonra taze bir seansa başlayın.
codex mcp listcodex mcp login flashdata --scopes mcp:researchopenclaw mcp doctor flashdata --probeopenclaw mcp login flashdata
openclaw mcp doctor flashdata --probeOAuth login bir API-key bağlantısını tamir etmiyor. Ev sahibinin ortamındaki anahtarı ve kaynak izinlerini kontrol edin. Yerel stdio için, MCP paketinin Node.js gereksinimini kontrol edin ve çevresini güncellemeden sonra ev sahibine yeniden başlayın.
node --versionSkill installed ama ajan onu bulamaz veya kullanamaz
Aynı projeyi kontrol edin, ev sahibi profili ve yerini yüklemek, sonra taze bir ajan seansına başlayın. CLI Görev becerilerine ihtiyaç duyar CLI; flashdata-mcp'in bağlantılı bir bağlantıya ihtiyacı var MCP sunucu. Bir yetenek yükleme bir sunucuya bağlanmaz veya hesap izni verir.
flashdata skills verify --agent codexflashdata skills verify --agent codex --skill flashdata-mcpopenclaw skills list --eligible
openclaw skills checkSık sık sorulan sorular
Bağlantılı Olmak
Bir AI ajanına ihtiyacım var mı?
Hayır. Kullanımı Kullanın HTTP API, Go/Python/TypeScript SDK, CLI veya konsol doğrudan. MCP ve beceriler ajanlar için ek seçeneklerdir.
Hangi arayüzü seçmeliyim?
Bir kullanım kullanın SDK veya veya veya HTTP API Bir uygulama içinde, CLI terminal görevleri ve MCP Çünkü bir MCP- aciz ev sahibi. Beceriler, CLI görevleri veya MCP araçlarına bağlı olarak talimatlar sağlar; kimlik doğrulamayı değiştirmezler.
Tekrarlanan görevler için kimlikleri yeniden kullanabilir miyim?
Evet. Sahibi erişim kullanın ve aynı korunan CLI profili, runtime secret veya MCP bağlantısını koruyun. API-key erişimi için, recurringAllowed: true'u kontrol edin. Ev sahibiniz veya programcınız programı çalışır.
Yerel ayarlar geri dönüyor mu?
Hayır. API anahtarı veya konsoldaki bağlantıyı geri döndürün. Yerel ayarları sadece yerel kopyaları ortadan kaldırır.
Denemeler ve krediler
Bir ajan FlashData'u işaret etmeden deneyebilir mi?
Evet, CLI veya API'ye geçici erişime uygun olarak. Aynı profili ve kayıt kanıtını yeniden kullanın. Devam eden kullanım, mevcut bir sahibi API anahtarının iddia edilmesine veya mevcut bir sahibine ihtiyaç duyuyor.
Başka bir deneme hibesini eklemeyi iddia ediyor mu?
Kendini talep etmek ekstra deneme kredisi vermiyor. Future istekleri sahibinin hesabı bakiyesini kullanır; kullanılmayan geçici krediler transfer edilmez. Yeni yaratılan bir hesap normal işaret-kredi politikasını takip eder.
Kredi kapakımı kaç tane talep edebilir?
Hesap dengesi ve kaynak fiyatlandırması kontrol edin. İstek notları kaynağa bağlıdır ve karışık kaynak görevleri bir dengeyi paylaşır. YouTube Download, sabit bir istek sayımı değil, indirilen tarafından fiyatlandırılmıştır.
Kaynaklar ve sonuçlar
Neden ajanım aramayabilir ama indirmez?
İndirin sahibi erişim, youtube_download izni ve varış depolama. Geçici denemeler ve mcp:research OAuth İndirme dahil değildir. Yetkili bir sahibi API anahtar bunu kullanarak kullanabilir CLI, HTTP veya veya veya MCP.
Google Search tam web siteleri geri döndürür mi?
Arama sonuçlarını ve alıntıları döndürür. Uygulamanız veya acenteniz seçilen URLs'yu okur.
FlashData video özetleri veya komutlar üretiyor mu?
Metadata'yı ve mevcut satırları alır. Kayıp kuyruklar yaratmaz; modeliniz mevcut sonuçlardan bir özet yazıyor.
Yine de sıkıştı? Asgari bir rapor gönder
HTTP hata bedenini veya CLI JSON hatasını stderr'dan diagnostic.json olarak kurtarın. tanımlayıcılar sadece başarısız bir komuttan sonra. Anahtarları tut, özel sorgu metni ve raporun dışında URLs imzalamıştır. JSON yanıtları için, HTTP statüsü diagnostic-status.txt'dan rapor edin.
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.jsonUTC zamanı:
Müşteri + sürüm:
Kaynak + sahne (ya da gönder / anket / getir):
HTTP statüsü + hata kodu:
ID / iş ID / ID:
Submission results: kabul / reddedildi / bilinmeyen
Beklenmiş vs gerçek sonuç: