# Crediti e prezzi

Vedi cosa costa una richiesta, fino a che punto il tuo saldo va e come aggiungere crediti.

Riferimento canonico: https://flashdata.dev/it/docs/guides/credits-and-billing
Recensito: 2026-11-04 da FlashData

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

## Come l'uso è addebitato

| Lavoro | Base di Billing |
| --- | --- |
| Google Ricerca / YouTube Data | Per richiesta. Ogni pagina o elemento batch è una richiesta; i risultati di ricerca non sono. |
| YouTube Download | Per byte consegnato al vostro deposito. |
| L'equilibrio, i prezzi, i limiti e l'uso legge | Nessun credito di query. Si applicano ancora i limiti di lettura. |

- [Piani e piani](https://flashdata.dev/it/pricing)

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

## Controllare l'equilibrio e i prezzi

Utilizzare Billing nella console, o eseguire questi controlli gratuiti. Questo esempio prezzi cinque Google Cerca richieste senza inviarle.

### CLI

Utilizzare l'accesso CLI salvato. Per un profilo chiamato, append --profile NAME a ogni comando. Queste letture non spendono crediti di query.

#### Leggi di account gratuito

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

- [Impostare una chiave](https://flashdata.dev/it/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Richiede Bash e cURL 7.76+. Salta il prompt dei tasti nascosti se il tuo ambiente già fornisce FLASHDATA_API_KEY. Eseguire i comandi di lettura nello stesso terminale.

#### Impostare la chiave · saltare se già configurato

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

#### Leggi l'account JSON

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

Salta il prompt dei tasti nascosti se FLASHDATA_API_KEY è già impostato. Eseguire i comandi di lettura nello stesso terminale.

#### Impostare la chiave · saltare se già configurato

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

#### Leggi l'account JSON

```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
}
```


- [Aprire Billing](https://flashdata.dev/app/billing)
- [Confrontare i piani](https://flashdata.dev/it/pricing)

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

### Leggi il preventivo

Utilizzare availableCredits dall'equilibrio. Nei prezzi, richiedere disponibili: true e leggere estimatedCredits. CLI JSON avvolge ogni risposta dell'account nei dati. Il prezzo seguente è illustrativo; utilizzare il valore restituito per il tuo account.

#### Risposta dei prezzi · campi rilevanti

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


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

## Quante richieste è credito 1?

A 0.02 credits per ricerca, 1 copre fino a 50 Google ricerche. A 0.01 per richiesta di metadati, copre fino a richieste di metadati 100 YouTube. Questi sono usi alternativi di un equilibrio; utilizzare i prezzi restituiti al momento della stima.

| Esempio di workload | Costo | Rimanere |
| --- | --- | --- |
| 50 Google ricerche | 50 × 0.02 = 1 credito | Crediti 0 |
| Richieste di metadati 100 YouTube | 100 × 0.01 = 1 credito | Crediti 0 |
| Ricerca 20 Google + richieste di metadati 30 | Crediti 0.4 + 0.3 = 0.7 | Crediti 0.3 |

### Calcola con il prezzo restituito

```text
costo del compito = numero di richiesta × creditsPerRequest
richieste convenienti = pavimento (availableCredits ÷ creditsPerRequest)
```


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

### YouTube Scarica gli usi bytes

Con il permesso youtube_download, leggere creditsPerTb e bytesPerUnit. Costo = byte consegnate ÷ bytesPerUnit × creditsPerTb. estimatedCredits è null perché un numero di richieste non può prevedere byte consegnate.

#### Leggi il tasso di download · gratis

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

- [Scarica le scelte di costo e di uscita](https://flashdata.dev/it/docs/guides/youtube-download-guide/reference.md#formats)

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

## Crediti dopo la richiesta

Controllare il saldo del proprietario dopo la consegna delle credenziali. Approvazione permette all'agente di spendere quel saldo condiviso; non acquista crediti, autorizza il checkout o crea un tappo di spesa per-agent separato.

| Fase | Quale equilibrio paga? |
| --- | --- |
| prova temporaneo | Il suo saldo di prova limitato al tempo, per le fonti ammissibili. |
| Rivendicato da un account esistente | Le future richieste utilizzano il saldo condiviso del proprietario. I crediti di prova non utilizzati non si trasferiscono. |
| Rivenduto dopo nuovo inserimento | Si applica l'ammissibilità di registrazione normale. Il reclamo non aggiunge un'altra sovvenzione di credito di iscrizione. |

- [Provare e rivendicare il passaggio attraverso](https://flashdata.dev/it/docs/guides/agent-onboarding/reference.md)

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

## Aggiungi crediti

1. In Billing, rivedere il piano o top-up, termini totali e di rinnovo prima di completare il checkout.
2. Dopo il pagamento, controllare lo stato di pagamento e l'equilibrio in Billing. Un checkout reindirizzare da solo non è la conferma.
3. Confronta l'utilizzo dell'attività salvata con lo stesso intervallo di date dell'account e fonti. Altre chiavi possono spendere da questo equilibrio anche.

- [Billing e fatture](https://flashdata.dev/app/billing)
- [Monitorare l'utilizzo dell'account](https://flashdata.dev/it/docs/guides/usage-and-limits/reference.md#usage)

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

## Se i numeri non corrispondono

Un saldo o un prezzo letto non riserva crediti. Controllare l'utilizzo effettivo della query, altre attività del conto e il lavoro in-flight. I riassunti d'uso possono ritardo dietro query recenti o rimborsi; confrontare la stessa gamma di tempo e autorizzazioni di origine. Su 402, pausa lavoro e rivedere l'equilibrio invece di creare un altro prova.

