# FAQ und Fehlerbehebung

Überprüfen Sie Ihren Zugriff, beheben Sie eine fehlgeschlagene Anfrage oder finden Sie eine Antwort zur Verwendung von FlashData.

Kanonische Referenz: https://flashdata.dev/de/docs/guides/troubleshooting
Test: 2026-11-04 von FlashData

- [Behebung eines Fehlers](https://flashdata.dev/de/docs/guides/troubleshooting/reference.md#fix) — Befehle und Fixes nach Symptom
- [Gemeinsame Fragen](https://flashdata.dev/de/docs/guides/troubleshooting/reference.md#faq) — Zugang, Credits und Daten

<a id="diagnose"></a>

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

### CLI

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

```bash
flashdata --version
flashdata doctor --offline
flashdata auth status --json
```

- [Einrichten eines Schlüssels](https://flashdata.dev/de/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Verwenden Sie den vorhandenen FLASHDATA_API_KEY der Aufgabe im selben Terminal, Container oder geplanten Job. Erfordert cURL 7.76+.

#### Lesen Sie das Konto JSON

```bash
(
: "${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'
)
```


### PowerShell 7

Verwenden Sie den vorhandenen FLASHDATA_API_KEY der Aufgabe im selben Terminal, Container oder geplanten Job.

#### Lesen Sie das Konto JSON

```powershell
& {
  $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
}
```


- [401 / 403: Anmeldeinformationen](https://flashdata.dev/de/docs/guides/troubleshooting/reference.md#credentials)
- [402: Credits](https://flashdata.dev/de/docs/guides/troubleshooting/reference.md#credits)
- [429: Tariflimit](https://flashdata.dev/de/docs/guides/troubleshooting/reference.md#rate-limit)
- [400 / 422: Anfrage](https://flashdata.dev/de/docs/guides/troubleshooting/reference.md#request)
- [Ausstehende oder gescheiterte Tätigkeit](https://flashdata.dev/de/docs/guides/troubleshooting/reference.md#jobs)
- [Timeout / 5xx](https://flashdata.dev/de/docs/guides/troubleshooting/reference.md#uncertain)
- [MCP-Verbindung](https://flashdata.dev/de/docs/guides/troubleshooting/reference.md#mcp)

<a id="check-result"></a>

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


<a id="fix"></a>

## Finden und beheben Sie das Problem

Öffnen Sie das Symptom, das Ihrem Fehler entspricht. Verwenden Sie IDs und Quittungen von der ursprünglichen Aufgabe.


<a id="runtime"></a>

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

#### Bash

##### Suchen Sie die ausführbare

```bash
command -v flashdata
flashdata --version
flashdata doctor --offline
```


#### PowerShell

##### Suchen Sie die ausführbare

```powershell
Get-Command flashdata
flashdata --version
flashdata doctor --offline
```


- [CLI Installation](https://flashdata.dev/de/docs/guides/flashdata-cli/reference.md#install)
- [Profile und staatliche Verzeichnisse](https://flashdata.dev/de/docs/guides/cli-automation/reference.md#profiles)

<a id="credentials"></a>

### 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

```bash
flashdata auth login --replace
flashdata auth status --json
```

- [Schlüsselberechtigungen und Rotation](https://flashdata.dev/de/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [Wiedereinziehung von Forderungen](https://flashdata.dev/de/docs/guides/troubleshooting/reference.md#claim)
- [MCP Reconnect](https://flashdata.dev/de/docs/guides/troubleshooting/reference.md#mcp)

<a id="claim"></a>

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

#### Bereits genehmigt

##### Abschluss und Überprüfung

```bash
flashdata auth finish --wait --timeout 10m
flashdata auth status --json
```


#### Link abgelaufen

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

##### Erneuern Sie den Claim Link

```bash
flashdata auth claim
```


- [Forderung und Übergabe](https://flashdata.dev/de/docs/guides/agent-onboarding/reference.md#help)
- [Überprüfen Sie den Besitzerzugriff auf wiederkehrende Aufgaben](https://flashdata.dev/de/docs/guides/recurring-tasks/reference.md)

<a id="credits"></a>

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

#### CLI

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

```bash
flashdata account balance
flashdata account pricing --source google_search --request-count 1
```

- [Einrichten eines Schlüssels](https://flashdata.dev/de/docs/guides/api-keys-and-permissions/reference.md#store)

#### Bash / cURL

Verwenden Sie den vorhandenen FLASHDATA_API_KEY der Aufgabe im selben Terminal, Container oder geplanten Job. Erfordert cURL 7.76+.

##### Lesen Sie das Konto JSON

```bash
(
: "${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'
)
```


#### PowerShell 7

Verwenden Sie den vorhandenen FLASHDATA_API_KEY der Aufgabe im selben Terminal, Container oder geplanten Job.

##### Lesen Sie das Konto JSON

```powershell
& {
  $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
}
```


- [Billing](https://flashdata.dev/app/billing)
- [Testzugang und Kontoverknüpfung](https://flashdata.dev/de/docs/guides/agent-onboarding/reference.md)
- [Preise für andere Quellen](https://flashdata.dev/de/docs/guides/credits-and-billing/reference.md)

<a id="rate-limit"></a>

### 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
# 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

```bash
flashdata account limits
```

- [Zinslimits und Backoff](https://flashdata.dev/de/docs/guides/usage-and-limits/reference.md)

<a id="request"></a>

### 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

```bash
flashdata query --input request.json --mode async --dry-run --json
```

- [Quellenanfragereferenzen](https://flashdata.dev/de/docs/reference/reference.md)
- [Privater Download-Eingang](https://flashdata.dev/de/docs/guides/cli-automation/reference.md#storage)
- [Überprüfen Sie einen bestehenden Job](https://flashdata.dev/de/docs/guides/troubleshooting/reference.md#jobs)

<a id="jobs"></a>

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

#### CLI

##### Überprüfen Sie den gespeicherten Job · Bash / jq

```bash
# 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

```bash
flashdata jobs wait JOB_ID
```

##### Abgeschlossen · Verwenden eines neuen Ausgabedateinamens

```bash
flashdata jobs result JOB_ID --output recovered-result.json
```


#### HTTP / cURL

##### Überprüfen Sie den gespeicherten Job

```bash
# 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
)
```


- [HTTP Polling und Ergebnisabruf](https://flashdata.dev/de/docs/guides/async-batch/reference.md)
- [Ausstehende Stellenkapazität](https://flashdata.dev/de/docs/guides/usage-and-limits/reference.md)

<a id="uncertain"></a>

### 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

```bash
flashdata runs show RUN_ID
```

#### Bestätigte akzeptierte Arbeit wiederherstellen

```bash
flashdata runs recover RUN_ID
```

- [Anfrageverlauf](https://flashdata.dev/app/jobs)
- [Rückforderungsentscheidungen](https://flashdata.dev/de/docs/guides/agent-recovery/reference.md)

<a id="output"></a>

### 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

```bash
flashdata runs show RUN_ID
```

- [Ausgeben von Dateien und Ausführen von Recovery](https://flashdata.dev/de/docs/guides/cli-automation/reference.md)

<a id="results"></a>

### Leere Suche, fehlende Untertitel oder unlesbarer Download

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

#### Google Search

Wenn der Status erledigt ist und organisch leer ist, lockern Sie die Abfragefilter. Behalten Sie das leere Ergebnis in Ihrem Aufgabenaufzeichnung.

##### Gespeicherte Ergebnisse prüfen · Bash / jq

```bash
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.json
```

- [Suchfilter und Paginierung](https://flashdata.dev/de/docs/guides/google-search-guide/reference.md)

#### YouTube-Beschriftungen

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

##### Verfügbare Sprachen prüfen · Bash / jq

```bash
jq '.results[0].transcriptLanguages' metadata.json
```

- [Wählen Sie einen Caption Track](https://flashdata.dev/de/docs/guides/youtube-data-guide/reference.md#captions)

#### YouTube Download

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

##### Lieferung prüfen · Bash / jq

```bash
jq '.results[0] | {file_url, file_size, md5}' delivery.json
```

- [Größe und Prüfsumme überprüfen](https://flashdata.dev/de/docs/guides/youtube-download-guide/reference.md#delivery)


<a id="mcp"></a>

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

#### Codex

Ö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

```bash
codex mcp list
```

##### Nur wenn OAuth Login erforderlich ist

```bash
codex mcp login flashdata --scopes mcp:research
```

- [Codex Server-Einrichtung](https://flashdata.dev/de/docs/integrations/codex/reference.md)

#### OpenClaw

##### Sonde den konfigurierten Server

```bash
openclaw mcp doctor flashdata --probe
```

##### Nur wenn OAuth Login erforderlich ist

```bash
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probe
```

- [OpenClaw Server-Einrichtung](https://flashdata.dev/de/docs/integrations/openclaw/reference.md)

#### API-Schlüssel / lokaler Server

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

##### für lokale Stdio

```bash
node --version
```

- [Hosted API-Schlüssel und lokales MCP Setup](https://flashdata.dev/de/docs/integrations/mcp-clients/reference.md)


<a id="skills"></a>

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

#### Codex · CLI Fähigkeiten

##### Überprüfen Sie das Standard-CLI Skill Bundle

```bash
flashdata skills verify --agent codex
```


#### Codex · MCP

##### Überprüfen Sie nur die optionale MCP Fertigkeit

```bash
flashdata skills verify --agent codex --skill flashdata-mcp
```


#### OpenClaw

##### Verfügbarkeit der Fähigkeiten prüfen

```bash
openclaw skills list --eligible
openclaw skills check
```


- [Fähigkeiten installieren oder aktualisieren](https://flashdata.dev/de/docs/guides/agent-skill/reference.md)
- [MCP](https://flashdata.dev/de/docs/integrations/mcp-clients/reference.md)

<a id="faq"></a>

## Häufig gestellte Fragen


<a id="faq-access"></a>

### Verbunden werden

| Fragestellung | Antwort |
| --- | --- |
| 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. |

- [Wählen Sie ein Interface](https://flashdata.dev/de/docs/reference.md)
- [Wiederkehrende Aufgabeneinrichtung](https://flashdata.dev/de/docs/guides/recurring-tasks/reference.md)
- [Verbundene Agenten](https://flashdata.dev/app/settings/connections)

<a id="faq-billing"></a>

### Trials und Credits

| Fragestellung | Antwort |
| --- | --- |
| 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. |

- [Testzugang und Kontoverknüpfung](https://flashdata.dev/de/docs/guides/agent-onboarding/reference.md)
- [Berechnung der Anzahl der Anfragen](https://flashdata.dev/de/docs/guides/credits-and-billing/reference.md)
- [Registrierungs- und Antragslimits](https://flashdata.dev/de/docs/guides/usage-and-limits/reference.md)

<a id="faq-results"></a>

### Quellen und Ergebnisse

| Fragestellung | Antwort |
| --- | --- |
| 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. |

- [Google Search](https://flashdata.dev/de/docs/guides/google-search-guide/reference.md)
- [YouTube Data](https://flashdata.dev/de/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/de/docs/guides/youtube-download-guide/reference.md)

<a id="support"></a>

## 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

```bash
flashdata auth status --json 2> diagnostic.json
```

### Extrahieren von Fehlerkennungen · Bash / jq

```bash
# 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

```text
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:
```

- [Fehlercode-Referenz](https://flashdata.dev/de/docs/errors/reference.md)
- [Support kontaktieren](https://flashdata.dev/de/contact)
