Przejdź do treści
PL
Uzyskaj klucz API
Przeglądaj dokumentację

Pierwsze kroki

FAQ i rozwiązywanie problemów

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.

Bezpłatne czytanie konta
flashdata --version
flashdata doctor --offline
flashdata auth status --json

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.

Zlokalizuj plik wykonywalny
command -v flashdata
flashdata --version
flashdata doctor --offline

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

  1. 401: sprawdź, czy klucz nie wygasł, został cofnięty lub nieprawidłowo skonfigurowany. 403: porównaj żądane źródło z zakresami identyfikacyjnymi.
  2. 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.
Zastąp i zweryfikuj zapisany klucz właściciela
flashdata auth login --replace
flashdata auth status --json

Zatwierdzono 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ę.

Zakończ i weryfikuj
flashdata auth finish --wait --timeout 10m
flashdata auth status --json

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

Bezpłatne czytanie konta
flashdata account balance
flashdata account pricing --source google_search --request-count 1

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

Uchwyć odpowiedź · 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
)
Sprawdzić zdolność konta
flashdata account limits

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

Potwierdzenie bez płatnego składania
flashdata query --input request.json --mode async --dry-run --json

Praca 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łądNastępna akcja
pending / processingPoczekajcie na tę samą pracę, nie składajcie jej ponownie.
completedPobierz i zapisać istniejący wynik.
failedSprawdź job.error przed przedłożeniem poprawionych prac.
404Sprawdź zadanie ID i konto wysyłające.
409Wyniki nie są gotowe. Kontynuuj sondaże tej samej pracy.
410Składowane JSON wygasło po upływie godzin 24. Użyj zapisanej kopii; dostarczone media mają własne przechowywanie danych.
Sprawdź zapisane zadanie · 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
)
Nadal działa · użyj zwróconego JOB_ID
flashdata jobs wait JOB_ID
Zakończone · użyj nowej nazwy pliku wyjściowego
flashdata jobs result JOB_ID --output recovered-result.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.

Sprawdź najpierw · zastąp RUN_ID
flashdata runs show RUN_ID
Odzyskanie potwierdzonej pracy
flashdata runs recover RUN_ID

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

Sprawdź oryginalną operację
flashdata runs show RUN_ID

Puste wyszukiwanie, brakujące podpisy lub nieczytelny pobór

Polecenia te odczytują tylko lokalne pliki wyników, nie kopertę CLI stdout.

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

Zaznacz konfigurację
codex mcp list
Tylko wtedy, gdy wymagane jest logowanie OAuth
codex mcp login flashdata --scopes mcp:research

Umieję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.

Zaznacz domyślny pakiet umiejętności CLI
flashdata skills verify --agent codex

Czę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.

Uchwyć darmowe sprawdzenie dostępu CLI · Bash
flashdata auth status --json 2> diagnostic.json
Identyfikatory błędów podczas ekstrakcji · 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
Sprawozdanie uzupełniające
Czas 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: