Parcourir la documentation
Premiers pas
Vérifiez votre accès, corrigez une requête en échec ou trouvez une réponse sur l’utilisation de FlashData.
Sur cette page
Commencer par une vérification gratuite de l’accès
Lancez la vérification dans l’environnement où la tâche a échoué. Utilisez ses identifiants existants ; ces commandes ne soumettent aucune requête.
Réutilisez l’accès enregistré dans la CLI. Pour un profil nommé, ajoutez --profile NAME à chaque commande. Ces lectures ne consomment pas de crédits de requête.
flashdata --version
flashdata doctor --offline
flashdata auth status --jsonUtilisez la FLASHDATA_API_KEY existante de la tâche dans le même terminal, conteneur ou job planifié. Nécessite 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'
)Utilisez la FLASHDATA_API_KEY existante de la tâche dans le même terminal, conteneur ou job planifié.
& {
$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
}Points à vérifier
L’identité doit indiquer access: ready et inclure votre source dans scopes. Dans le JSON de la CLI, elle se trouve sous data.identity.identity ; exigez aussi data.accessVerified: true. Une commande réussie avec accessVerified: false n’a pas vérifié l’accès.
Pour un profil CLI nommé, ajoutez --profile NAME à chaque commande ci-dessous. Conservez le --state-dir et l’utilisateur du système d’origine. FLASHDATA_API_KEY prend le pas sur une clé CLI enregistrée ; les SDK et les hôtes MCP utilisent leur propre configuration d’identifiants.
Identifier et corriger le problème
Ouvrez le symptôme correspondant à votre erreur. Utilisez les identifiants et les reçus de la tâche d’origine.
Commande introuvable ou profil manquant
Exécutable absent : installez la version adaptée à votre système et à votre processeur, puis ajoutez son dossier à PATH. Profil manquant : utilisez l’utilisateur du système et le répertoire d’état d’origine. Vérifiez aussi l’environnement du planificateur ou du conteneur.
command -v flashdata
flashdata --version
flashdata doctor --offlineGet-Command flashdata
flashdata --version
flashdata doctor --offline401 / 403 : clé, permission ou expiration
Pour remplacer une clé propriétaire enregistrée, collez la clé approuvée dans la saisie masquée. Si FLASHDATA_API_KEY est définie, mettez plutôt ce secret à jour dans l’environnement d’exécution ; enregistrer une autre clé CLI ne la remplacera pas.
- 401 : vérifiez si la clé est expirée, révoquée ou mal configurée. 403 : comparez la source demandée aux scopes de l’identité.
- REST et les SDK utilisent X-API-Key. Un jeton OAuth MCP ne remplace pas une clé API. Pour l’accès temporaire, utilisez la procédure de reprise du rattachement ci-dessous.
flashdata auth login --replace
flashdata auth status --jsonRattachement approuvé, mais l’agent utilise encore l’essai
Terminez la transmission dans le profil CLI qui a créé le rattachement. Le propriétaire effectue l’inscription, la vérification de l’adresse e-mail et le consentement dans le navigateur ; la CLI reçoit les identifiants.
flashdata auth finish --wait --timeout 10m
flashdata auth status --jsonDemandez un nouveau lien pour l’essai existant, laissez le propriétaire approuver, puis lancez auth finish. Ne relancez pas init.
flashdata auth claim402 : crédits insuffisants
Comparez availableCredits au tarif actuel de votre source. Rattachez un essai épuisé pour utiliser le solde du propriétaire, ou laissez-le consulter Billing avant de réessayer.
Réutilisez l’accès enregistré dans la CLI. Pour un profil nommé, ajoutez --profile NAME à chaque commande. Ces lectures ne consomment pas de crédits de requête.
flashdata account balance
flashdata account pricing --source google_search --request-count 1Utilisez la FLASHDATA_API_KEY existante de la tâche dans le même terminal, conteneur ou job planifié. Nécessite 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'
)Utilisez la FLASHDATA_API_KEY existante de la tâche dans le même terminal, conteneur ou job planifié.
& {
$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 : attendre avant de réessayer
Lisez Retry-After dans la réponse en échec : une durée en secondes ou une date HTTP. Attendez jusqu’à cette échéance et réduisez les opérations simultanées. L’inscription à l’essai autorise trois inscriptions par IP sur une fenêtre de 24 heures ; réutilisez le profil et la preuve d’inscription d’origine.
Cette lecture gratuite montre comment enregistrer les en-têtes, le statut et le corps. Utilisez le Retry-After de l’opération qui a échoué ; les limites de requêtes, d’inscription et de lecture du compte peuvent différer.
# 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 : paramètres rejetés ou échec de traitement
Lisez code, detail et fieldErrors dans l’erreur HTTP. Corrigez le corps de requête, enregistrez-le dans request.json, puis validez-le. Gardez les identifiants de stockage Download dans un fichier d’entrée privé. Si 422 provient du résultat d’une tâche existante, examinez d’abord job.error.
flashdata query --input request.json --mode async --dry-run --jsonTâche en attente, ou HTTP 200 avec une tâche en échec
Lisez la tâche à partir de submission.json, votre reçu asynchrone enregistré. HTTP 200 indique que la lecture d’état a réussi ; job.status indique l’état de la tâche, ou data.status dans le JSON CLI. Pour Batch, enregistrez l’entrée correspondante de queries dans submission.json.
| État ou erreur | Action suivante |
|---|---|
| pending / processing | Attendez la même tâche sans la soumettre à nouveau. |
| completed | Récupérez et enregistrez le résultat existant. |
| failed | Examinez job.error avant de soumettre une opération corrigée. |
| 404 | Vérifiez l’identifiant de tâche et le compte utilisé pour la soumission. |
| 409 | Les résultats ne sont pas prêts. Continuez à consulter la même tâche. |
| 410 | Le JSON conservé a expiré après 24 heures. Utilisez votre copie enregistrée ; le média livré suit la conservation de son propre stockage. |
# 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
)Délai dépassé / 5xx : la tâche a-t-elle été acceptée ?
Examinez l’exécution d’origine et History avant de retenter un POST. Reprenez une tâche dont l’acceptation est confirmée. Si l’acceptation est inconnue, conservez l’identifiant d’exécution et contactez le support ; changer d’identifiant et soumettre à nouveau peut doubler la facturation.
flashdata runs show RUN_IDflashdata runs recover RUN_IDCLI output_exists : le fichier de résultat existe déjà
La CLI n’écrase pas les fichiers --output. Lisez le fichier existant ou choisissez un nouveau nom de sortie en conservant le --run-id et la requête d’origine. N’inventez pas un nouvel identifiant d’exécution pour contourner cette erreur.
flashdata runs show RUN_IDRecherche vide, sous-titres absents ou téléchargement illisible
Ces commandes lisent uniquement les fichiers de résultats locaux, pas l’enveloppe stdout de la CLI.
Si status vaut done et organic est vide, assouplissez les filtres de recherche. Conservez ce résultat vide dans l’enregistrement de la tâche.
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.jsonLes métadonnées indiquent les codes de langue, pas si une piste est manuelle ou automatique. Choisissez une langue proposée et définissez explicitement auto : true pour automatique, false pour manuelle. Aucune piste correspondante signifie qu’aucun sous-titre n’est disponible pour cette sélection ; FlashData n’en génère pas de remplacement.
jq '.results[0].transcriptLanguages' metadata.jsonLisez le reçu delivery.json terminé. Téléchargez l’objet avec les identifiants de votre stockage de destination, puis comparez sa taille et son MD5 au reçu. Une file_url privée ne devient pas publique après la livraison.
jq '.results[0] | {file_url, file_size, md5}' delivery.jsonOutils MCP absents ou authentification expirée
Vérifiez l’hôte qui exécute la tâche. Un serveur présent dans la liste confirme sa configuration, mais pas une connexion fonctionnelle. Si la connexion OAuth hébergée demande une authentification, lancez sa commande de connexion, terminez l’approbation dans le navigateur, puis actualisez la liste des outils.
Ouvrez /mcp dans la CLI Codex pour vérifier l’état de la connexion et les outils. Dans l’application, vérifiez le serveur configuré et démarrez une nouvelle session après les changements de configuration.
codex mcp listcodex mcp login flashdata --scopes mcp:researchopenclaw mcp doctor flashdata --probeopenclaw mcp login flashdata
openclaw mcp doctor flashdata --probeUne connexion OAuth ne répare pas une connexion par clé API. Vérifiez la clé dans l’environnement de l’hôte et ses permissions de sources. Pour stdio en local, vérifiez la version de Node.js requise par le paquet MCP et redémarrez l’hôte après la mise à jour de son environnement.
node --versionSkill installé mais introuvable ou inutilisable par l’agent
Vérifiez le projet, le profil de l’hôte et l’emplacement d’installation, puis démarrez une nouvelle session d’agent. Les skills de tâches CLI nécessitent la CLI ; flashdata-mcp nécessite un serveur MCP connecté. Installer un skill ne connecte pas de serveur et n’accorde pas de permissions sur le compte.
flashdata skills verify --agent codexflashdata skills verify --agent codex --skill flashdata-mcpopenclaw skills list --eligible
openclaw skills checkQuestions fréquentes
Se connecter
Ai-je besoin d’un agent IA ?
Non. Utilisez directement l’API HTTP, les SDK Go/Python/TypeScript, la CLI ou la console. MCP et les skills offrent des options supplémentaires pour les agents.
Quelle interface choisir ?
Utilisez un SDK ou l’API HTTP dans une application, la CLI pour les tâches de terminal et MCP dans un hôte compatible. Les skills fournissent des instructions pour les tâches CLI ou les outils MCP connectés ; ils ne remplacent pas l’authentification.
Puis-je réutiliser mes identifiants pour les tâches récurrentes ?
Oui. Utilisez un accès propriétaire et conservez le même profil CLI protégé, secret d’exécution ou connexion MCP. Pour l’accès par clé API, vérifiez recurringAllowed: true. Votre hôte ou votre planificateur gère les horaires.
Supprimer les paramètres locaux révoque-t-il l’accès ?
Non. Révoquez la clé API ou la connexion dans la console. Supprimer les paramètres locaux retire uniquement cette copie locale.
Essais et crédits
Un agent peut-il essayer FlashData avant l’inscription ?
Oui, avec un accès temporaire éligible via la CLI ou l’API d’intégration des agents. Réutilisez le même profil et la même preuve d’inscription. Pour continuer, rattachez cet accès à un compte ou utilisez une clé API propriétaire existante.
Le rattachement accorde-t-il de nouveaux crédits d’essai ?
Le rattachement n’accorde pas de crédits d’essai supplémentaires. Les requêtes suivantes utilisent le solde du compte propriétaire ; les crédits temporaires inutilisés ne sont pas transférés. Un nouveau compte suit la politique normale de crédits à l’inscription.
Combien de requêtes mes crédits permettent-ils ?
Consultez le solde du compte et les tarifs des sources. Le nombre de requêtes dépend de la source ; les tâches qui en combinent plusieurs partagent le même solde. YouTube Download est facturé au volume téléchargé en octets, et non selon un nombre fixe de requêtes.
Sources et résultats
Pourquoi mon agent peut-il rechercher, mais pas télécharger ?
Le téléchargement nécessite un accès propriétaire, la permission youtube_download et un stockage de destination. Les essais temporaires et le scope OAuth mcp:research n’incluent pas Download. Une clé API propriétaire autorisée permet de l’utiliser via la CLI, HTTP ou MCP.
Google Search renvoie-t-il les pages web complètes ?
Il renvoie des résultats de recherche et des extraits. Votre application ou votre agent lit les URL sélectionnées.
FlashData génère-t-il des résumés vidéo ou des sous-titres ?
Il récupère les métadonnées et les sous-titres existants. Il ne génère pas les sous-titres manquants ; votre modèle rédige un résumé à partir des résultats disponibles.
Toujours bloqué ? Préparer un rapport minimal
Enregistrez le corps d’erreur HTTP ou l’erreur JSON CLI de stderr dans diagnostic.json. Extrayez les identifiants uniquement après une commande en échec. Excluez du rapport les clés, le texte privé des requêtes et les URL signées. Pour les réponses non JSON, indiquez le statut HTTP de 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.jsonHeure UTC :
Client et version :
Source et étape (auth / submit / poll / fetch) :
Statut HTTP et code d’erreur :
Identifiant de requête / de tâche / d’exécution :
Résultat de soumission : accepted / rejected / unknown
Résultat attendu et résultat constaté :