Documentatie bekijken
Aan de slag
Controleer uw toegang, repareer een mislukt verzoek of vind een antwoord over het gebruik van FlashData.
Op deze pagina
Begin met een gratis toegangscontrole
Voer de controle uit waar de taak mislukt is. Gebruik de bestaande referenties; deze commando's geven geen query.
Gebruik uw opgeslagen CLI toegang. Voor een genoemd profiel, voeg --profile NAAM toe aan elk commando. Deze lezingen besteden geen query kredieten.
flashdata --version
flashdata doctor --offline
flashdata auth status --jsonGebruik de bestaande FLASHDATA_API_KEY van de taak in dezelfde terminal, container of geplande taak. Vereist 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'
)Gebruik de bestaande FLASHDATA_API_KEY van de taak in dezelfde terminal, container of geplande taak.
& {
$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
}Wat te controleren
De identiteit moet access: ready hebben en uw bron in scopes opnemen. In CLI JSON is de identiteit data.identity.identity; ook data.accessVerified: true vereist. Een succesvol commando met accessVerified: false heeft geen toegang geverifieerd.
Voor een CLI profiel met de naam, voeg --profile NAAM toe aan elk commando hieronder. Houd de originele --state-dir en OS gebruiker. FLASHDATA_API_KEY overschrijft een opgeslagen CLI-sleutel; SDK's en MCP hosts gebruiken hun eigen credential configuratie.
Het probleem zoeken en oplossen
Open het symptoom dat overeenkomt met uw fout. Gebruik IDs en ontvangstbewijzen van de oorspronkelijke taak.
Opdracht niet gevonden of profiel ontbreekt
Geen uitvoerbaar bestand: installeer de release voor uw OS/CPU en voeg de directory toe aan PATH. Ontbrekend profiel: gebruik de originele OS-gebruiker en statusmap. Controleer ook in de planner of container.
command -v flashdata
flashdata --version
flashdata doctor --offlineGet-Command flashdata
flashdata --version
flashdata doctor --offline401 / 403: sleutel, toepassingsgebied of vervaldatum
Om een opgeslagen eigenaarsleutel te vervangen, plak de goedgekeurde sleutel in de verborgen prompt. Als FLASHDATA_API_KEY is ingesteld, update dat geheim in de runtime in plaats daarvan; het opslaan van een andere CLI sleutel zal het niet overschrijven.
- 401: controleer op een verlopen, ingetrokken of verkeerd geconfigureerde sleutel. 403: vergelijk de gevraagde bron met de scopes van de identiteit.
- REST en SDK gebruiken X-API-Key. Een MCP OAuth token kan een API sleutel niet vervangen. Voor tijdelijke toegang, gebruik de claim recuperatie hieronder.
flashdata auth login --replace
flashdata auth status --jsonClaim goedgekeurd, maar de agent heeft nog steeds toegang tot een proces.
Voltooi de overdracht in hetzelfde CLI-profiel dat de claim creëerde. De eigenaar voltooit aanmelding, e-mail verificatie en toestemming in de browser; de CLI ontvangt de credential.
flashdata auth finish --wait --timeout 10m
flashdata auth status --jsonVraag een nieuwe link aan voor de bestaande trial, laat de eigenaar het goedkeuren en voer dan auth finish uit. Draai init niet opnieuw.
flashdata auth claim402: onvoldoende kredieten
Vergelijk availableCredits met de huidige prijs voor uw bron. Claim een uitgeput proefwerk om de saldo van de eigenaar te gebruiken, of laat de eigenaar Billing beoordelen voordat opnieuw te proberen.
Gebruik uw opgeslagen CLI toegang. Voor een genoemd profiel, voeg --profile NAAM toe aan elk commando. Deze lezingen besteden geen query kredieten.
flashdata account balance
flashdata account pricing --source google_search --request-count 1Gebruik de bestaande FLASHDATA_API_KEY van de taak in dezelfde terminal, container of geplande taak. Vereist 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'
)Gebruik de bestaande FLASHDATA_API_KEY van de taak in dezelfde terminal, container of geplande taak.
& {
$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: wacht alvorens opnieuw te proberen
Lees Retry-After over het falende antwoord: seconden of een HTTP-datum. Wacht tot dan en verminder concurrency. Trial registratie maakt het mogelijk drie registraties per IP per 24-uur venster; hergebruik het oorspronkelijke profiel en registratie bewijs.
Deze gratis gelezen toont het opslaan van headers, status en lichaam. Gebruik de Retry-After van de operatie die is mislukt; query, registratie en account-read limieten kunnen verschillen.
# 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: afgewezen invoer of verwerking storing
Lees code, detail en fieldErrors van de HTTP fout. Corrigeer het verzoek lichaam, sla het op als request.json en valideer het vervolgens. Bewaar de opslaggegevens van Download in een privé invoerbestand. Als 422 afkomstig is van het resultaat van een bestaande taak, inspecteer job.error eerst.
flashdata query --input request.json --mode async --dry-run --jsonAfgelopen taak, of HTTP 200 met een mislukte taak
Lees de taak van submission.json, uw opgeslagen async-bon. HTTP 200 betekent dat de status is geslaagd; job.status is het taakresultaat (data.status in CLI JSON). Voor Batch, sla de relevante invoer uit queries als submission.json.
| Status of fout | Volgende actie |
|---|---|
| pending / processing | Wacht op hetzelfde werk; dien het niet opnieuw in. |
| completed | Het bestaande resultaat ophalen en opslaan. |
| failed | Inspecteer job.error voordat u gecorrigeerd werk indient. |
| 404 | Controleer de taak ID en het inzendaccount. |
| 409 | De resultaten zijn nog niet klaar. Blijf hetzelfde doen. |
| 410 | Opgeslagen JSON verlopen na 24 uren. Gebruik uw opgeslagen kopie; geleverd media heeft een eigen opslagruimte. |
# 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: werd de taak geaccepteerd?
Controleer de originele run en History voordat u een POST opnieuw probeert. Herstellen van een bevestigde geaccepteerde baan. Als acceptatie onbekend is, houd de ID-run en contactondersteuning; het wijzigen van IDs en het opnieuw inzenden kunnen de kosten dupliceren.
flashdata runs show RUN_IDflashdata runs recover RUN_IDCLI output_exists: het resultaatbestand bestaat al
De CLI overschrijft --output-bestanden niet. Lees het bestaande bestand, of kies een nieuwe uitvoer bestandsnaam terwijl de oorspronkelijke --run-id en verzoek. Vind geen nieuwe ID uit om deze fout te omzeilen.
flashdata runs show RUN_IDLege zoekopdracht, ontbrekende bijschriften of onleesbare download
Deze commando's lezen alleen lokale resultaatbestanden, niet de CLI's stdout envelop.
Als status is voltooid en organisch leeg is, lossere query filters. Bewaar de lege uitkomst in je takenlijst.
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.jsonMetadata bevat taalcodes, niet of een track handmatig of automatisch is. Kies een beursgenoteerde taal en stel auto explicitly: true in voor automatisch, false voor handleiding. Geen matching track betekent geen bijschriften voor die selectie; FlashData genereert geen vervanging.
jq '.results[0].transcriptLanguages' metadata.jsonLees het complete delivery.json ontvangstbewijs. Download het object met uw bestemming-opslaggegevens, vergelijk vervolgens de grootte ervan en MD5 met het ontvangstbewijs. Een privé file_url wordt na levering niet openbaar.
jq '.results[0] | {file_url, file_size, md5}' delivery.jsonMCP-gereedschappen ontbreken of verlopen
Controleer de host die de taak uitvoert. Een opgegeven server bevestigt de configuratie, geen werkende verbinding. Als de geconfigureerde gehoste OAuth-verbinding inloggen vereist, voer dan het inlogcommando uit en vul de browsergoedkeuring in en vernieuw de lijst met gereedschappen.
Open /mcp in de Codex CLI om de verbindingsstatus en -tools te controleren. Controleer in de app de geconfigureerde server en start een nieuwe sessie na wijzigingen van de setup.
codex mcp listcodex mcp login flashdata --scopes mcp:researchopenclaw mcp doctor flashdata --probeopenclaw mcp login flashdata
openclaw mcp doctor flashdata --probeOAuth login repareert geen API-sleutel verbinding. Controleer de sleutel in de omgeving van de host en de bronrechten. Voor lokale stdio, controleer de MCP pakket Node.js eis en herstart de host na het bijwerken van de omgeving.
node --versionSkill geïnstalleerd, maar de agent kan het niet vinden of gebruiken
Controleer hetzelfde project, host profiel en installeer locatie en start vervolgens een nieuwe agent sessie. CLI taakvaardigheden hebben de CLI nodig; flashdata-mcp heeft een aangesloten MCP server nodig. Het installeren van een vaardigheid verbindt geen server of verleent accountmachtigingen.
flashdata skills verify --agent codexflashdata skills verify --agent codex --skill flashdata-mcpopenclaw skills list --eligible
openclaw skills checkVeelgestelde vragen
Verbinding maken
Heb ik een Al-agent nodig?
Nee. Gebruik de HTTP API, Go/Python/TypeScript SDK, CLI of console direct. MCP en vaardigheden zijn extra opties voor agenten.
Welke interface moet ik kiezen?
Gebruik een SDK of HTTP API in een app, de CLI voor terminaltaken, en MCP voor een MCP-geschikte host. Vaardigheden bieden instructies voor ofwel CLI taken of verbonden MCP tools; ze vervangen geen authenticatie.
Kan ik referenties hergebruiken voor terugkerende taken?
Ja. Gebruik de eigenaar toegang en behoud hetzelfde beschermde CLI profiel, runtime secret of MCP verbinding. Voor toegang tot API-toets, controleer recurringAllowed: true. Uw gastheer of planner doet het schema.
Herroept het verwijderen van lokale instellingen de toegang?
Nee. Trek de API-sleutel of verbinding in de console in. Het verwijderen van lokale instellingen verwijdert alleen die lokale kopie.
Proeven en kredieten
Kan een agent FlashData proberen voordat u zich aanmeldt?
Ja, met in aanmerking komende tijdelijke toegang via de CLI of aan boord API. Gebruik hetzelfde profiel en registratiebewijs opnieuw. Voortgezette gebruik moet claimen of een bestaande eigenaar API sleutel.
Voegt het claimen nog een processubsidie toe?
Het claimen zelf verleent geen extra studiepunten. Toekomstige verzoeken maken gebruik van de rekeningsaldo van de eigenaar; ongebruikte tijdelijke kredieten niet overmaken. Een nieuw aangemaakte rekening volgt het normale signup-kredietbeleid.
Hoeveel verzoeken kunnen mijn credits dekken?
Controleer rekening evenwicht en bron prijzen. Het aantal verzoeken hangt af van de bron en gemengde brontaken delen één saldo. YouTube Download wordt geprijsd door gedownloade bytes, geen vaste aanvraagtelling.
Bronnen en resultaten
Waarom kan mijn agent zoeken maar niet downloaden?
Download heeft toegang tot de eigenaar, youtube_download toestemming en opslag van de bestemming nodig. Tijdelijke proeven en mcp:research OAuth bevatten geen Download. Een geautoriseerde eigenaar API sleutel kan het gebruiken via CLI, HTTP of MCP.
Geeft Google Search volledige webpagina's terug?
Het geeft zoekresultaten en fragmenten terug. Uw app of agent leest de geselecteerde URLs.
Genereert FlashData videosamenvattingen of bijschriften?
Het haalt metadata en bestaande bijschriften op. Het genereert geen ontbrekende bijschriften; uw model schrijft een samenvatting van de beschikbare resultaten.
Nog steeds vast? Een minimaal rapport versturen
Sla de HTTP foutlichaam of CLI JSON fout uit stderr als diagnostic.json. Alleen identificaties uitpakken na een mislukt commando. Hou sleutels, privé-query tekst en ondertekend URLs uit het rapport. Voor niet-JSON-antwoorden, rapporteer de HTTP-status van 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.jsonUTC-tijd:
Client + versie:
Bron + stadium (auth / submit / poll / fetch):
HTTP status + foutcode:
Vraag ID / job ID / run ID:
Inzendingsresultaat: aanvaard / afgewezen / onbekend
Verwacht vs het werkelijke resultaat: