Dokumentation durchsuchen
Erste Schritte
Überprüfen Sie Ihren Zugriff, beheben Sie eine fehlgeschlagene Anfrage oder finden Sie eine Antwort zur Verwendung von FlashData.
Auf dieser Seite
Beginnen Sie mit einem kostenlosen Zugangscheck
Führen Sie den Check aus, bei dem die Aufgabe fehlgeschlagen ist. Verwenden Sie die vorhandenen Anmeldeinformationen; diese Befehle senden keine Abfrage.
Verwenden Sie Ihren gespeicherten CLI-Zugang. Für ein benanntes Profil, anhängen --profile NAME zu jedem Befehl. Diese Reads geben keine Abfrage-Credits aus.
flashdata --version
flashdata doctor --offline
flashdata auth status --jsonVerwenden Sie den vorhandenen FLASHDATA_API_KEY der Aufgabe im selben Terminal, Container oder geplanten Job. Erfordert 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'
)Verwenden Sie den vorhandenen FLASHDATA_API_KEY der Aufgabe im selben Terminal, Container oder geplanten Job.
& {
$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
}Was zu überprüfen ist
Die Identität sollte access: ready haben und Ihre Quelle in Scopes einschließen. In CLI JSON befindet sich die Identität in data.identity.identity; erfordern auch data.accessVerified: true. Ein erfolgreicher Befehl mit accessVerified: false hat den Zugriff nicht verifiziert.
Fügen Sie für ein benanntes CLI-Profil den --profile-NAME an jeden Befehl unten an. Behalten Sie den ursprünglichen --state-dir und OS Benutzer. FLASHDATA_API_KEY überschreibt einen gespeicherten CLI-Schlüssel; SDKs und MCP-Hosts verwenden ihre eigene Berechtigungskonfiguration.
Finden und beheben Sie das Problem
Öffnen Sie das Symptom, das Ihrem Fehler entspricht. Verwenden Sie IDs und Quittungen von der ursprünglichen Aufgabe.
Befehl nicht gefunden oder Profil fehlt
Keine ausführbare Datei: Installieren Sie die Version für Ihr OS/CPU und fügen Sie das Verzeichnis zu PATH hinzu. Fehlendes Profil: Verwenden Sie das ursprüngliche OS-Benutzer- und Statusverzeichnis. Überprüfen Sie auch im Inneren des Schedulers oder Containers.
command -v flashdata
flashdata --version
flashdata doctor --offlineGet-Command flashdata
flashdata --version
flashdata doctor --offline401 / 403: Schlüssel, Umfang oder Ablauf
Um einen gespeicherten Besitzerschlüssel zu ersetzen, fügen Sie den genehmigten Schlüssel in die versteckte Eingabeaufforderung ein. Wenn FLASHDATA_API_KEY gesetzt ist, aktualisieren Sie dieses Geheimnis stattdessen in der Laufzeit; das Speichern eines anderen CLI-Schlüssels wird es nicht überschreiben.
- 401: Überprüfen Sie auf einen abgelaufenen, widerrufenen oder falsch konfigurierten Schlüssel. 403: Vergleichen Sie die angeforderte Quelle mit den Umfangen der Identität.
- REST und SDKs verwenden X-API-Key. Ein MCP OAuth-Token kann einen API-Schlüssel nicht ersetzen. Für den temporären Zugriff verwenden Sie die Claim Recovery unten.
flashdata auth login --replace
flashdata auth status --jsonAnspruch genehmigt, aber der Agent hat noch Testzugang
Beenden Sie die Übergabe im selben CLI-Profil, das den Anspruch erstellt hat. Der Besitzer schließt die Anmeldung, die E-Mail-Verifizierung und die Zustimmung im Browser ab; der CLI erhält den Nachweis.
flashdata auth finish --wait --timeout 10m
flashdata auth status --jsonFordern Sie einen neuen Link für die bestehende Testversion an, lassen Sie den Besitzer genehmigen und führen Sie dann auth finish aus. Führen Sie init nicht erneut aus.
flashdata auth claim402: unzureichende Credits
Vergleichen Sie availableCredits mit dem aktuellen Preis für Ihre Quelle. Fordern Sie eine erschöpfte Testversion an, um das Guthaben des Besitzers zu verwenden, oder lassen Sie den Besitzer Billing überprüfen, bevor Sie es erneut versuchen.
Verwenden Sie Ihren gespeicherten CLI-Zugang. Für ein benanntes Profil, anhängen --profile NAME zu jedem Befehl. Diese Reads geben keine Abfrage-Credits aus.
flashdata account balance
flashdata account pricing --source google_search --request-count 1Verwenden Sie den vorhandenen FLASHDATA_API_KEY der Aufgabe im selben Terminal, Container oder geplanten Job. Erfordert 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'
)Verwenden Sie den vorhandenen FLASHDATA_API_KEY der Aufgabe im selben Terminal, Container oder geplanten Job.
& {
$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: Warten Sie, bevor Sie es erneut versuchen
Lesen Sie Retry-After über die fehlgeschlagene Antwort: Sekunden oder ein HTTP-Datum. Warten Sie bis dahin und reduzieren Sie die Gleichzeitigkeit. Die Testregistrierung ermöglicht drei Registrierungen pro IP pro 24-Stundenfenster; Wiederverwendung des Originalprofils und des Registrierungsnachweises.
Diese kostenlose Lektüre zeigt sparende Header, Status und Körper. Verwenden Sie den Retry-After aus der fehlgeschlagenen Operation; Abfrage-, Registrierungs- und Kontoleselimits können abweichen.
# 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: abgelehnter Eingabe- oder Verarbeitungsfehler
Lesen Sie Code, Detail und fieldErrors aus dem HTTP-Fehler. Korrigieren Sie den Request-Body, speichern Sie ihn als request.json und validieren Sie ihn dann. Bewahren Sie die Download-Speicheranmeldeinformationen in einer privaten Eingabedatei auf. Wenn 422 aus einem bestehenden Jobergebnis stammt, prüfen Sie zuerst job.error.
flashdata query --input request.json --mode async --dry-run --jsonAusstehender Job oder HTTP 200 mit einem fehlgeschlagenen Job
Lesen Sie den Job von submission.json, Ihrem gespeicherten async-Beleg. HTTP 200 bedeutet den Status gelesen erfolgreich; job.status ist das Task-Ergebnis (data.status in CLI JSON). Speichern Sie für Batch den entsprechenden Eintrag aus Abfragen als submission.json.
| Zustand oder Fehler | Nächste Maßnahme |
|---|---|
| pending / processing | Warten Sie auf den gleichen Job; reichen Sie ihn nicht erneut ein. |
| completed | Holen und speichern Sie das vorhandene Ergebnis. |
| failed | Überprüfen Sie job.error, bevor Sie korrigierte Arbeiten einreichen. |
| 404 | Überprüfen Sie den Job ID und das einreichende Konto. |
| 409 | Die Ergebnisse sind noch nicht fertig. Wählen Sie den gleichen Job. |
| 410 | Gespeicherte JSON abgelaufen nach 24 Stunden. Verwenden Sie Ihre gespeicherte Kopie; Zugestellte Medien haben ihre eigene Speicheraufbewahrung. |
# 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: Wurde die Aufgabe angenommen?
Überprüfen Sie den Originallauf und History, bevor Sie einen POST erneut versuchen. Wiederherstellen Sie einen bestätigten angenommenen Job. Wenn die Akzeptanz unbekannt ist, behalten Sie den Lauf von ID und kontaktieren Sie den Support; das Ändern von IDs und das erneute Senden können Gebühren duplizieren.
flashdata runs show RUN_IDflashdata runs recover RUN_IDCLI output_exists: Ergebnisdatei bereits vorhanden
Die CLI überschreibt keine --output Dateien. Lesen Sie die vorhandene Datei oder wählen Sie einen neuen Ausgabedateinamen aus, während Sie den ursprünglichen --run-id beibehalten und anfordern. Erfinden Sie keinen neuen Lauf ID, um diesen Fehler zu umgehen.
flashdata runs show RUN_IDLeere Suche, fehlende Untertitel oder unlesbarer Download
Diese Befehle lesen nur lokale Ergebnisdateien, nicht den Stdout-Umschlag des CLI.
Wenn der Status erledigt ist und organisch leer ist, lockern Sie die Abfragefilter. Behalten Sie das leere Ergebnis in Ihrem Aufgabenaufzeichnung.
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.jsonMetadaten listen Sprachcodes auf, nicht ob ein Track manuell oder automatisch ist. Wählen Sie eine aufgeführte Sprache und setzen Sie auto explicitly: true für automatisch, false für manuell. Keine übereinstimmende Spur bedeutet keine Beschriftungen für diese Auswahl; FlashData generiert keinen Ersatz.
jq '.results[0].transcriptLanguages' metadata.jsonLesen Sie den abgeschlossenen delivery.json-Beleg. Laden Sie das Objekt mit Ihren Zielspeicherdaten herunter und vergleichen Sie dann seine Größe und MD5 mit der Quittung. Ein privates file_url wird nach der Lieferung nicht öffentlich.
jq '.results[0] | {file_url, file_size, md5}' delivery.jsonMCP-Tools fehlen oder die Authentifizierung abgelaufen ist
Überprüfen Sie den Host, der die Aufgabe ausführt. Ein aufgelisteter Server bestätigt die Konfiguration, keine Arbeitsverbindung. Wenn die konfigurierte gehostete OAuth-Verbindung eine Anmeldung erfordert, führen Sie den Anmeldebefehl aus und vervollständigen Sie die Browsergenehmigung, und aktualisieren Sie dann die Toolliste.
Öffnen Sie /mcp im Codex CLI, um den Verbindungsstatus und die Tools zu überprüfen. Überprüfen Sie in der App den konfigurierten Server und starten Sie nach den Setup-Änderungen eine neue Sitzung.
codex mcp listcodex mcp login flashdata --scopes mcp:researchopenclaw mcp doctor flashdata --probeopenclaw mcp login flashdata
openclaw mcp doctor flashdata --probeOAuth Login repariert keine API-Schlüsselverbindung. Überprüfen Sie den Schlüssel in der Umgebung des Hosts und dessen Quellberechtigungen. Überprüfen Sie bei lokalen Stdios die Node.js-Anforderung des MCP-Pakets und starten Sie den Host nach der Aktualisierung seiner Umgebung neu.
node --versionSkill installiert, aber der Agent kann es nicht finden oder verwenden
Überprüfen Sie dasselbe Projekt, Hostprofil und den Installationsort und starten Sie dann eine neue Agentensitzung. CLI-Task Skills benötigen den CLI; flashdata-mcp benötigt einen angeschlossenen MCP Server. Durch die Installation eines Fertigkeits wird keine Verbindung zu einem Server hergestellt oder Kontoberechtigungen gewährt.
flashdata skills verify --agent codexflashdata skills verify --agent codex --skill flashdata-mcpopenclaw skills list --eligible
openclaw skills checkHäufig gestellte Fragen
Verbunden werden
Benötige ich einen AI Agent?
Nein. Verwenden Sie HTTP API, Go/Python/TypeScript SDK, CLI oder Konsole direkt. MCP und Fähigkeiten sind zusätzliche Optionen für Agenten.
Welches Interface soll ich wählen?
Verwenden Sie ein SDK oder HTTP API in einer App, das CLI für Terminalaufgaben und MCP für einen MCP-fähigen Host. Skills bieten Anweisungen für CLI-Aufgaben oder verbundene MCP-Tools; sie ersetzen keine Authentifizierung.
Kann ich Anmeldeinformationen für wiederkehrende Aufgaben wiederverwenden?
Ja. Verwenden Sie den Besitzerzugriff und bewahren Sie das gleiche geschützte CLI-Profil, das Laufzeitgeheimnis oder die MCP-Verbindung auf. Für API-Schlüsselzugriff, überprüfen Sie recurringAllowed: true. Ihr Host oder Scheduler führt den Zeitplan aus.
Entzieht das Löschen lokaler Einstellungen den Zugriff?
Nein. Widerrufen Sie den API-Schlüssel oder die Verbindung in der Konsole. Durch das Löschen lokaler Einstellungen wird nur diese lokale Kopie entfernt.
Trials und Credits
Kann ein Agent FlashData vor der Anmeldung ausprobieren?
Ja, mit berechtigtem temporärem Zugriff über CLI oder Onboarding API. Verwenden Sie das gleiche Profil und den gleichen Registrierungsnachweis. Für die fortgesetzte Nutzung ist ein API-Schlüssel oder ein vorhandener Besitzer erforderlich.
Wird behauptet, einen weiteren Probezuschuss hinzuzufügen?
Sich selbst zu beanspruchen, gewährt keine zusätzlichen Probekredite. Zukünftige Anfragen verwenden den Kontostand des Eigentümers; nicht verwendete temporäre Kredite werden nicht übertragen. Ein neu erstelltes Konto folgt der normalen Anmelde-Kredit-Politik.
Wie viele Anfragen können meine Credits abdecken?
Überprüfen Sie den Kontostand und die Quellenpreise. Die Anzahl der Anfragen hängt von der Quelle ab, und Aufgaben mit gemischter Quelle teilen sich ein Guthaben. YouTube Download wird nach heruntergeladenen Bytes berechnet, nicht nach einer festen Anforderungszählung.
Quellen und Ergebnisse
Warum kann mein Agent suchen, aber nicht herunterladen?
Der Download benötigt den Besitzerzugriff, die youtube_download-Berechtigung und den Zielspeicher. Temporäre Tests und mcp:research OAuth beinhalten keinen Download. Ein autorisierter Besitzer des API-Schlüssels kann ihn über CLI, HTTP oder MCP verwenden.
Gibt Google Search vollständige Webseiten zurück?
Es gibt Suchergebnisse und Auszüge zurück. Ihre App oder Ihr Agent liest das ausgewählte URLs.
Erzeugt FlashData Videozusammenfassungen oder Bildunterschriften?
Es ruft Metadaten und vorhandene Beschriftungen ab. Es erzeugt keine fehlenden Beschriftungen; Ihr Modell schreibt eine Zusammenfassung aus verfügbaren Ergebnissen.
Bleiben Sie stecken? Senden Sie einen minimalen Bericht
Speichern Sie den HTTP-Fehlerkörper oder den CLI JSON-Fehler von stderr als diagnostic.json. Extrahieren von Identifikatoren nur nach einem fehlgeschlagenen Befehl. Halten Sie Schlüssel, privaten Abfragetext und signiertes URLs aus dem Bericht heraus. Bei Antworten, die nicht zu JSON gehören, ist der HTTP-Status aus diagnostic-status.txt zu melden.
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-Zeit:
Client + Version:
Quelle + Bühne (auth / submit / poll / fetch):
HTTP Status + Fehlercode:
Anfordern ID / Job ID / ID ausführen:
Einreichungsergebnis: akzeptiert / abgelehnt / unbekannt
Erwartetes vs. tatsächliches Ergebnis: