# Crédits et tarifs

Découvrez le coût des requêtes, ce que permet votre solde et comment ajouter des crédits.

Référence canonique : https://flashdata.dev/fr/docs/guides/credits-and-billing
Vérifié le 2026-11-04 par FlashData

<a id="model"></a>

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

- [Forfaits et recharges](https://flashdata.dev/fr/pricing)

<a id="balance"></a>

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

### CLI

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

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

- [Configurer une clé](https://flashdata.dev/fr/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Né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.

#### Définir la clé · ignorer si elle est déjà configurée

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

#### Lire les données JSON du compte

```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=5' || exit
printf '\n'
)
```


### PowerShell 7

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.

#### Définir la clé · ignorer si elle est déjà configurée

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

#### Lire les données JSON du compte

```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=5"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```


- [Ouvrir la facturation](https://flashdata.dev/app/billing)
- [Comparer les forfaits](https://flashdata.dev/fr/pricing)

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

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

#### Réponse des tarifs · champs utiles

```json
{
  "requestCount": 5,
  "prices": [
    {
      "source": "google_search",
      "available": true,
      "creditsPerRequest": 0.02,
      "estimatedCredits": 0.1
    }
  ]
}
```


<a id="estimate"></a>

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

### Calculer avec le tarif renvoyé

```text
coût de la tâche = nombre de requêtes × creditsPerRequest
requêtes possibles = floor(availableCredits ÷ creditsPerRequest)
```


<a id="download"></a>

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

#### Consulter le tarif de téléchargement · gratuit

```bash
flashdata account pricing --source youtube_download
```

- [Coût du téléchargement et choix de sortie](https://flashdata.dev/fr/docs/guides/youtube-download-guide/reference.md#formats)

<a id="trial"></a>

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

- [Parcours d’essai et de rattachement](https://flashdata.dev/fr/docs/guides/agent-onboarding/reference.md)

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

## Ajouter des crédits

1. Dans la facturation, vérifiez le forfait ou la recharge, le montant total et les conditions de renouvellement avant de terminer le paiement.
2. 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.
3. 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.

- [Facturation et factures](https://flashdata.dev/app/billing)
- [Suivre la consommation du compte](https://flashdata.dev/fr/docs/guides/usage-and-limits/reference.md#usage)

<a id="cost-help"></a>

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

