Überspringen zum Inhalt
DE
API-Schlüssel
Dokumentation durchsuchen

Erste Schritte

FAQ und Fehlerbehebung

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

Kostenloses Konto liest
flashdata --version
flashdata doctor --offline
flashdata auth status --json

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.

Suchen Sie die ausführbare
command -v flashdata
flashdata --version
flashdata doctor --offline

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

  1. 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.
  2. 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.
Ersetzen und Verifizieren eines gespeicherten Besitzerschlüssels
flashdata auth login --replace
flashdata auth status --json

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

Abschluss und Überprüfung
flashdata auth finish --wait --timeout 10m
flashdata auth status --json

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

Kostenloses Konto liest
flashdata account balance
flashdata account pricing --source google_search --request-count 1

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.

Erfassen Sie die Antwort · 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
)
Kapazität der Kontrollkonten
flashdata account limits

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

Validieren ohne bezahlte Einreichung
flashdata query --input request.json --mode async --dry-run --json

Ausstehender 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 FehlerNächste Maßnahme
pending / processingWarten Sie auf den gleichen Job; reichen Sie ihn nicht erneut ein.
completedHolen 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.
409Die Ergebnisse sind noch nicht fertig. Wählen Sie den gleichen Job.
410Gespeicherte JSON abgelaufen nach 24 Stunden. Verwenden Sie Ihre gespeicherte Kopie; Zugestellte Medien haben ihre eigene Speicheraufbewahrung.
Überprüfen Sie den gespeicherten Job · 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
)
Immer noch läuft · Verwenden Sie das zurückgegebene JOB_ID
flashdata jobs wait JOB_ID
Abgeschlossen · Verwenden eines neuen Ausgabedateinamens
flashdata jobs result JOB_ID --output recovered-result.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.

Erst prüfen · RUN_ID ersetzen
flashdata runs show RUN_ID
Bestätigte akzeptierte Arbeit wiederherstellen
flashdata runs recover RUN_ID

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

Überprüfen Sie den Original-Lauf
flashdata runs show RUN_ID

Leere Suche, fehlende Untertitel oder unlesbarer Download

Diese Befehle lesen nur lokale Ergebnisdateien, nicht den Stdout-Umschlag des CLI.

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

Prüfkonfiguration
codex mcp list
Nur wenn OAuth Login erforderlich ist
codex mcp login flashdata --scopes mcp:research

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

Überprüfen Sie das Standard-CLI Skill Bundle
flashdata skills verify --agent codex

Hä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.

Erfassen Sie einen kostenlosen CLI-Zugangscheck · Bash
flashdata auth status --json 2> diagnostic.json
Extrahieren von Fehlerkennungen · 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
Unterstützungsbericht
UTC-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: