Przeglądaj dokumentację
Pierwsze kroki
Sprawdź swój dostęp, napraw nieudany wniosek lub znajdź odpowiedź o użyciu FlashData.
Na tej stronie
Zacznij od bezpłatnej kontroli dostępu
Sprawdź, gdzie zadanie nie powiodło się. Używaj istniejących uprawnień; komendy te nie składają zapytania.
Użyj zapisanego dostępu do CLI. Dla o nazwie profilu, przyłącz nazwę --profile do każdego polecenia. Te odczyty nie wydają kredytów zapytania.
flashdata --version
flashdata doctor --offline
flashdata auth status --jsonUżyj istniejącego FLASHDATA_API_KEY w tym samym terminalu, kontenerze lub zaplanowanym zadaniu. Wymaga 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'
)Użyj istniejącego FLASHDATA_API_KEY w tym samym terminalu, kontenerze lub zaplanowanym zadaniu.
& {
$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
}Co sprawdzić
Tożsamość powinna mieć access: ready i zawierać swoje źródło w skopach. W CLI JSON tożsamość znajduje się w data.identity.identity; wymagają również data.accessVerified: true. Udane polecenie z accessVerified: false nie zweryfikowało dostępu.
Dla profilu o nazwie CLI należy dołączyć nazwę --profile do każdego poniższego polecenia. Należy zachować oryginalnego użytkownika --state-dir i OS. FLASHDATA_API_KEY nadjeżdża zapisany klawisz CLI; Hosty SDK i MCP używają własnej konfiguracji kredytowej.
Znajdź i napraw problem
Otwórz symptom pasującym do twojego błędu. Użyj IDs i paragonów z oryginalnego zadania.
Polecenie nie znaleziono lub brak profilu
Brak wykonywalny: zainstalować wydanie dla OS/CPU i dodać jego katalog do PATH. Brak profilu: użyj oryginalnego katalogu użytkownika i stanu OS. Sprawdź też w terminarzu lub kontenerze.
command -v flashdata
flashdata --version
flashdata doctor --offlineGet-Command flashdata
flashdata --version
flashdata doctor --offline401 / 403: klucz, zakres lub wygaśnięcie
Aby zastąpić zapisany klucz właściciela, wklej zatwierdzony klucz w ukryty sygnał. Jeśli ustawiony jest FLASHDATA_API_KEY, zamiast tego zaktualizuj ten sekret w runtime; zapisywanie innego klawisza CLI nie spowoduje jego obejścia.
- 401: sprawdź, czy klucz nie wygasł, został cofnięty lub nieprawidłowo skonfigurowany. 403: porównaj żądane źródło z zakresami identyfikacyjnymi.
- REST i SDK używać X-API-Key. Symbol MCP OAuth nie może zastąpić klucza API. W celu uzyskania tymczasowego dostępu należy skorzystać z poniższych informacji dotyczących odzyskiwania wierzytelności.
flashdata auth login --replace
flashdata auth status --jsonZatwierdzono wniosek, ale agent nadal ma dostęp do procesu.
Zakończ przekazanie w tym samym profilu CLI, który stworzył roszczenie. Właściciel kończy podpisanie, weryfikację e-mail i zgodę w przeglądarce; CLI otrzymuje akredytację.
flashdata auth finish --wait --timeout 10m
flashdata auth status --jsonPoproś o nowy link do istniejącego procesu, niech właściciel zatwierdzi, a następnie uruchomić auth finish. Nie uruchamiaj ponownie init.
flashdata auth claim402: niewystarczające kredyty
Porównaj availableCredits z aktualną ceną dla źródła. Złóż wyczerpany proces, aby użyć bilansu właściciela, lub niech właściciel przeglądu Billing przed ponownym próbami.
Użyj zapisanego dostępu do CLI. Dla o nazwie profilu, przyłącz nazwę --profile do każdego polecenia. Te odczyty nie wydają kredytów zapytania.
flashdata account balance
flashdata account pricing --source google_search --request-count 1Użyj istniejącego FLASHDATA_API_KEY w tym samym terminalu, kontenerze lub zaplanowanym zadaniu. Wymaga 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'
)Użyj istniejącego FLASHDATA_API_KEY w tym samym terminalu, kontenerze lub zaplanowanym zadaniu.
& {
$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: czekać przed ponownym uruchomieniem
Przeczytaj Retry-After na nieudanej odpowiedzi: sekundy lub datę HTTP. Poczekaj do tego czasu i zmniejsz współzależność. Rejestracja próbna pozwala na trzy rejestracje na IP dla okna 24- godzinnego; ponownie użyć oryginalnego profilu i dowodu rejestracyjnego.
Ten darmowy odczyt pokazuje oszczędzanie nagłówków, statusu i ciała. Użyj Retry-After z operacji, która nie powiodła się; limity zapytania, rejestracji i odczytu konta mogą się różnić.
# 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: odrzucona awaria wejścia lub przetwarzania
Odczytaj kod, szczegóły i fieldErrors z błędu HTTP. Popraw organ, zapisz go jako request.json, a następnie potwierdzić. Zachowaj dane uwierzytelniające do pobrania w prywatnym pliku wejściowym. Jeśli 422 pochodzi z dotychczasowego wyniku pracy, najpierw sprawdź job.error.
flashdata query --input request.json --mode async --dry-run --jsonPraca w toku, lub HTTP 200 z nieudanym zadaniem
Przeczytaj zadanie z submission.json, zapisany paragon async. HTTP 200 oznacza stan odczytu zakończony sukcesem; job.status jest wynikiem zadania (data.status w CLI JSON). W przypadku Batch należy zapisać odpowiedni wpis z zapytań jako submission.json.
| Państwo lub błąd | Następna akcja |
|---|---|
| pending / processing | Poczekajcie na tę samą pracę, nie składajcie jej ponownie. |
| completed | Pobierz i zapisać istniejący wynik. |
| failed | Sprawdź job.error przed przedłożeniem poprawionych prac. |
| 404 | Sprawdź zadanie ID i konto wysyłające. |
| 409 | Wyniki nie są gotowe. Kontynuuj sondaże tej samej pracy. |
| 410 | Składowane JSON wygasło po upływie godzin 24. Użyj zapisanej kopii; dostarczone media mają własne przechowywanie danych. |
# 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: czy zadanie zostało przyjęte?
Przed ponownym wypróbowaniem POST należy sprawdzić oryginał i History. Odzyskam potwierdzoną pracę. Jeśli akceptacja jest nieznana, należy zachować bieg ID i wsparcie kontaktów; zmiana IDs i resubbationizacje mogą powielać opłaty.
flashdata runs show RUN_IDflashdata runs recover RUN_IDCLI output_exists: plik wyniku już istnieje
CLI nie zastępuje plików --output. Przeczytaj istniejący plik lub wybierz nową nazwę pliku wyjściowego, zachowując oryginał --run-id i żądanie. Nie wymyślaj nowego uruchomienia ID, aby obejść ten błąd.
flashdata runs show RUN_IDPuste wyszukiwanie, brakujące podpisy lub nieczytelny pobór
Polecenia te odczytują tylko lokalne pliki wyników, nie kopertę CLI stdout.
Jeśli status jest gotowy, a organiczny jest pusty, poluzować filtry zapytania. Zachowaj pusty wynik w swoim zapisie zadań.
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.jsonMetadane wymieniają kody językowe, a nie to, czy utwór jest ręczny czy automatyczny. Wybierz podany język i ustawić auto explicitly: true do automatycznego, false do ręcznego. Brak pasującej ścieżki oznacza brak zapisów dla tego wyboru; FlashData nie generuje zamiennika.
jq '.results[0].transcriptLanguages' metadata.jsonPrzeczytaj wypełniony paragon delivery.json. Pobierz obiekt za pomocą referencji destination- storage, a następnie porównaj jego rozmiar i MD5 z paragonem. Prywatny file_url nie staje się publicznie po dostawie.
jq '.results[0] | {file_url, file_size, md5}' delivery.jsonBrak narzędzi MCP lub brak uwierzytelniania
Sprawdź, czy gospodarz prowadzi zadanie. Wyszczególniony serwer potwierdza konfigurację, a nie połączenie robocze. Jeśli skonfigurowane połączenie z firmą OAuth wymaga logowania, uruchom polecenie logowania i kompletna zgoda przeglądarki, a następnie odśwież listę narzędzi.
Otwórz /mcp w Codex CLI, aby sprawdzić status połączenia i narzędzia. W aplikacji należy sprawdzić skonfigurowany serwer i rozpocząć świeżą sesję po zmianie konfiguracji.
codex mcp listcodex mcp login flashdata --scopes mcp:researchopenclaw mcp doctor flashdata --probeopenclaw mcp login flashdata
openclaw mcp doctor flashdata --probeOAuth logowanie nie naprawia połączenia z kluczami API-. Sprawdź klucz w środowisku hosta i jego prawa źródłowe. W przypadku lokalnego stdio, sprawdź wymagania MCP pakietu Node.js i ponownie uruchom hosta po aktualizacji jego środowiska.
node --versionUmiejętność zainstalowana, ale agent nie może jej znaleźć ani użyć
Sprawdź ten sam projekt, profil hosta i zainstaluj lokalizację, a następnie rozpocznij nową sesję agenta. Umiejętności zadaniowe CLI potrzebują CLI; flashdata- mcp potrzebuje podłączonego serwera MCP. Instalowanie umiejętności nie łączy praw do dostępu do serwera lub konta dotacji.
flashdata skills verify --agent codexflashdata skills verify --agent codex --skill flashdata-mcpopenclaw skills list --eligible
openclaw skills checkCzęsto zadawane pytania
Połączenia
Czy potrzebuję agenta AI?
Nie. Użyj HTTP API, Go/Python/TypeScript SDK, CLI lub konsoli bezpośrednio. MCP i umiejętności są dodatkowe opcje dla agentów.
Który interfejs powinienem wybrać?
Użyj SDK lub HTTP API wewnątrz aplikacji, CLI dla zadań terminalowych, a MCP dla hosta zdolnego do MCP-. Umiejętności zapewniają instrukcje dla zadań CLI lub podłączone narzędzia MCP; nie zastępują uwierzytelniania.
Czy mogę ponownie wykorzystać dane uwierzytelniające do powtarzających się zadań?
Tak. Użyj dostępu właściciela i zachować ten sam chroniony profil CLI, tajemnica runtime lub połączenie MCP. Aby uzyskać dostęp do klucza API- sprawdź recurringAllowed: true. Twój gospodarz lub terminarz prowadzi harmonogram.
Czy usuwanie lokalnych ustawień unieważnia dostęp?
Nie. Otworzyć klawisz API lub połączenie w konsoli. Usuwanie lokalnych ustawień usuwa tylko tę lokalną kopię.
Próby i kredyty
Czy agent może spróbować FlashData przed zapisaniem?
Tak, z kwalifikującym się tymczasowym dostępem przez CLI lub na pokładzie API. Użyj tego samego profilu i dowodu rejestracyjnego. Ciągłe potrzeby użytkowania twierdzą lub istniejącego właściciela API klucz.
Czy roszczenie o dotację na kolejny proces?
Twierdzenie, że nie przyznaje dodatkowych kredytów próbnych. Przyszłe wnioski wykorzystują saldo konta właściciela; niewykorzystane tymczasowe kredyty nie są przenoszone. Nowo utworzone konto jest zgodne z normalną polityką udzielania kredytów.
Ile wniosków może pokryć moje kredyty?
Sprawdź bilans konta i ceny źródeł. Liczenie żądań zależy od źródła, a mieszane zadania źródłowe dzielą się jednym saldem. YouTube Download jest wyceniany przez pobrane bajty, a nie stałą liczbę żądań.
Źródła i wyniki
Dlaczego mój agent może przeszukiwać, ale nie ściągać?
Pobieranie wymaga dostępu właściciela, zezwolenia youtube_download i miejsca przeznaczenia. Próby czasowe i mcp:research OAuth nie zawierają pobierania. Upoważniony właściciel klucza API może go używać poprzez CLI, HTTP lub MCP.
Czy Google Search zwraca pełną stronę internetową?
Zwraca wyniki wyszukiwania i fragmenty. Twoja aplikacja lub agent czyta wybrane URLs.
Czy FlashData generuje streszczenia lub podpisy wideo?
Pobiera metadane i istniejące podpisy. Nie generuje brakujących napisów; Twój model pisze podsumowanie z dostępnych wyników.
Nadal utknąłeś? Wyślij minimalny raport
Zapisz HTTP organ błędu lub CLI JSON Błąd z stderr jako diagnostic.json. Wyciągnij identyfikatory tylko po nieudanej komendzie. Keep Keys, prywatny tekst zapytania i podpisał URLs z raportu. W przypadku odpowiedzi non- JSON należy zgłosić status HTTP z 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.jsonCzas UTC:
Klient + wersja:
Źródło + etap (auth / submit / sonda / fetch):
Status HTTP + kod błędu:
Wniosek ID / praca ID / uruchomić ID:
Wynik zgłoszenia: przyjęty / odrzucony / nieznany
Oczekiwany wynik w porównaniu z rzeczywistym: