Parcourir la documentation
Premiers pas
Découvrez le coût des requêtes, ce que permet votre solde et comment ajouter des crédits.
Sur cette page
Comment la consommation est facturée
| Traitement | Unité de facturation |
|---|---|
| Google Search / YouTube Data | Par requête. Chaque page ou élément d’un batch compte comme une requête, pas chaque résultat de recherche. |
| YouTube Download | Par octet transféré vers votre stockage. |
| Consultation du solde, des tarifs, des limites et de la consommation | Aucun crédit de requête consommé. Les limites de lecture restent applicables. |
Vérifier le solde et les tarifs
Consultez la facturation dans la console ou exécutez ces vérifications gratuites. Cet exemple estime le prix de cinq requêtes Google Search sans les soumettre.
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 5Nécessite Bash et cURL 7.76+. Ignorez la saisie masquée si votre environnement fournit déjà FLASHDATA_API_KEY. Exécutez les commandes de lecture dans le même terminal.
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY(
: "${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=5' || exit
printf '\n'
)Ignorez la saisie masquée si FLASHDATA_API_KEY est déjà définie. Exécutez les commandes de lecture dans le même terminal.
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey& {
$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=5"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}Lire l’estimation
Lisez availableCredits dans la réponse de solde. Dans les tarifs, vérifiez available: true et lisez estimatedCredits. Le JSON de la CLI place chaque réponse de compte dans data. Le tarif ci-dessous est illustratif ; utilisez la valeur renvoyée pour votre compte.
{
"requestCount": 5,
"prices": [
{
"source": "google_search",
"available": true,
"creditsPerRequest": 0.02,
"estimatedCredits": 0.1
}
]
}Combien de requêtes permet 1 crédit ?
À 0.02 crédit par recherche, 1 crédit permet jusqu’à 50 recherches Google. À 0.01 crédit par requête de métadonnées, il permet jusqu’à 100 requêtes YouTube Metadata. Ce sont des utilisations alternatives d’un même solde ; calculez vos estimations avec les tarifs renvoyés pour votre compte.
| Exemple de traitement | Coût | Solde restant |
|---|---|---|
| 50 recherches Google | 50 × 0.02 = 1 crédit | 0 crédit |
| 100 requêtes YouTube Metadata | 100 × 0.01 = 1 crédit | 0 crédit |
| 20 recherches Google + 30 requêtes de métadonnées | 0.4 + 0.3 = 0.7 crédit | 0.3 crédit |
coût de la tâche = nombre de requêtes × creditsPerRequest
requêtes possibles = floor(availableCredits ÷ creditsPerRequest)YouTube Download est facturé en octets
Avec l’autorisation youtube_download, consultez creditsPerTb et bytesPerUnit. Coût = octets transférés ÷ bytesPerUnit × creditsPerTb. estimatedCredits vaut null, car un nombre de requêtes ne permet pas de prévoir le volume transféré.
flashdata account pricing --source youtube_downloadCrédits après rattachement
Vérifiez le solde du propriétaire après la transmission des identifiants. L’approbation permet à l’agent de consommer ce solde partagé ; elle n’achète pas de crédits, n’autorise pas un paiement et ne crée pas de plafond de dépenses par agent.
| Étape | Quel solde est utilisé ? |
|---|---|
| Essai temporaire | Son propre solde d’essai à durée limitée, pour les sources éligibles. |
| Rattachement à un compte existant | Les requêtes suivantes utilisent le solde partagé du propriétaire. Les crédits d’essai inutilisés ne sont pas transférés. |
| Rattachement après une nouvelle inscription | Les règles normales d’éligibilité à l’inscription s’appliquent. Le rattachement n’ajoute pas une seconde allocation de crédits d’inscription. |
Ajouter des crédits
- Dans la facturation, vérifiez le forfait ou la recharge, le montant total et les conditions de renouvellement avant de terminer le paiement.
- Après le paiement, vérifiez son état et le solde dans la facturation. Une simple redirection depuis la page de paiement ne confirme pas la transaction.
- Comparez la consommation des tâches enregistrées avec la même période et les mêmes sources du compte. D’autres clés peuvent également consommer ce solde.
Si les chiffres ne correspondent pas
Consulter le solde ou les tarifs ne réserve pas de crédits. Vérifiez la consommation réelle des requêtes, les autres activités du compte et les traitements en cours. Les résumés de consommation peuvent refléter les dernières requêtes ou les remboursements avec un délai ; comparez la même période et les mêmes autorisations de sources. En cas d’erreur 402, suspendez les tâches et vérifiez le solde au lieu de créer un autre essai.