Aller au contenu
FR
Obtenir une clé API
Parcourir la documentation

Premiers pas

FAQ et dépannage

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.

Consultations gratuites du compte
flashdata --version
flashdata doctor --offline
flashdata auth status --json

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.

Localiser l’exécutable
command -v flashdata
flashdata --version
flashdata doctor --offline

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

  1. 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é.
  2. 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.
Remplacer et vérifier une clé propriétaire enregistrée
flashdata auth login --replace
flashdata auth status --json

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

Terminer et vérifier
flashdata auth finish --wait --timeout 10m
flashdata auth status --json

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

Consultations gratuites du compte
flashdata account balance
flashdata account pricing --source google_search --request-count 1

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.

Capturer la réponse · 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
)
Examiner la capacité du compte
flashdata account limits

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

Valider sans soumission payante
flashdata query --input request.json --mode async --dry-run --json

Tâ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 erreurAction suivante
pending / processingAttendez la même tâche sans la soumettre à nouveau.
completedRécupérez et enregistrez le résultat existant.
failedExaminez job.error avant de soumettre une opération corrigée.
404Vérifiez l’identifiant de tâche et le compte utilisé pour la soumission.
409Les résultats ne sont pas prêts. Continuez à consulter la même tâche.
410Le JSON conservé a expiré après 24 heures. Utilisez votre copie enregistrée ; le média livré suit la conservation de son propre stockage.
Examiner la tâche enregistrée · 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
)
Encore en cours · utiliser le JOB_ID renvoyé
flashdata jobs wait JOB_ID
Terminée · choisir un nouveau nom de fichier de sortie
flashdata jobs result JOB_ID --output recovered-result.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.

Examiner d’abord · remplacer RUN_ID
flashdata runs show RUN_ID
Reprendre une opération confirmée acceptée
flashdata runs recover RUN_ID

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

Examiner l’exécution d’origine
flashdata runs show RUN_ID

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

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

Vérifier la configuration
codex mcp list
Uniquement si une connexion OAuth est requise
codex mcp login flashdata --scopes mcp:research

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

Vérifier le lot de skills CLI par défaut
flashdata skills verify --agent codex

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

Capturer une vérification gratuite de l’accès CLI · Bash
flashdata auth status --json 2> diagnostic.json
Extraire les identifiants d’erreur · 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
Rapport pour le support
Heure 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é :