# Créditos e preços

Veja o que custa um pedido, até onde vai o seu saldo e como adicionar créditos.

Referência canônica: https://flashdata.dev/pt/docs/guides/credits-and-billing
2026-11-04 por FlashData

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

## Como o uso é cobrado

| Trabalho | Base Billing |
| --- | --- |
| Google Pesquisa / Dados YouTube | Por pedido. Cada página ou item em lote é um pedido; buscas não são. |
| YouTube Download | Por byte entregue em seu depósito. |
| Equilíbrio, preços, limites e uso | Sem créditos de consulta. Os limites de leitura ainda se aplicam. |

- [Planos e recargas](https://flashdata.dev/pt/pricing)

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

## Verifique o equilíbrio e os preços

Use Billing no console, ou execute esses verificações grátis. Este exemplo custa cinco pedidos Google Search sem submetê-los.

### CLI

Use seu acesso CLI salvo. Para um perfil nomeado, adicione o nome --profile a cada comando. Essas leituras não gastam créditos de consulta.

#### Conta livre lê

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

- [Prepare uma chave](https://flashdata.dev/pt/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Requer Bash e cURL 7.76+. Pule a chave secreta se seu ambiente já fornecer FLASHDATA_API_KEY. Execute os comandos de leitura no mesmo terminal.

#### Defina a tecla · skip se já configurado

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

#### Leia a conta 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

Pule o prompt de chave escondida se FLASHDATA_API_KEY já está definido. Execute os comandos de leitura no mesmo terminal.

#### Defina a tecla · skip se já configurado

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

#### Leia a conta 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
}
```


- [Abra Billing](https://flashdata.dev/app/billing)
- [Compare os planos](https://flashdata.dev/pt/pricing)

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

### Leia a estimativa

Use availableCredits do equilíbrio. Em preços, requeira available: true e leia estimatedCredits. CLI JSON envolve cada resposta da conta em dados. O seguinte preço é ilustrativo: use o valor devolvido para sua conta.

#### Resposta de preços. Campos relevantes

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


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

## Quantos pedidos é crédito 1?

Em créditos 0.02 por busca, o crédito 1 cobre até as buscas 50 Google. No 0.01 por pedido de metadados, cobre até 100 YouTube Metadata. Estes são usos alternativos de um saldo; use seus preços devolvidos quando estimar.

| Exemplo de carga de trabalho | Custo | Restando |
| --- | --- | --- |
| 50 Google buscas | 50 × 0.02 = 1 crédito | 0 créditos |
| 100 YouTube pedidos de metadados | 100 × 0.01 = 1 crédito | 0 créditos |
| 20 Google buscas + pedidos de metadados 30 | 0.4 + 0.3 = 0.7 créditos | 0.3 créditos |

### Calcule com o preço devolvido

```text
Custo da tarefa = contagem de pedidos × creditsPerRequest
 Pedidos acessíveis = andar(availableCredits ÷ creditsPerRequest)
```


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

### YouTube Download usa bytes

Com permissão youtube_download, leia creditsPerTb e bytesPerUnit. Custo = bytes entregues bytesPerUnit × creditsPerTb. estimatedCredits É. null Porque uma contagem de pedidos não pode prever bytes entregues.

#### Leia a taxa de download · grátis

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

- [Baixe as escolhas de custo e saída](https://flashdata.dev/pt/docs/guides/youtube-download-guide/reference.md#formats)

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

## Créditos depois de reivindicar

Verifique o saldo do proprietário após a entrega da credencial. A aprovação permite que o agente gaste esse saldo compartilhado, não compra créditos, não autoriza o checkout ou cria um limite de gastos por agente separado.

| Estágio | Que saldo paga? |
| --- | --- |
| teste temporário | Seu próprio equilíbrio de tempo limitado, para fontes elegíveis. |
| Reivindicado por uma conta existente | Pedidos futuros usam o equilíbrio compartilhado do dono. Créditos de teste não usados não são transferidos. |
| Reclamado após nova inscrição | A elegibilidade de inscrição normal se aplica. Reclamar não adiciona outra bolsa de crédito. |

- [teste e apresentação de pedidos](https://flashdata.dev/pt/docs/guides/agent-onboarding/reference.md)

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

## Adicione créditos

1. Em Billing, reveja o plano ou os termos, total e renovação antes de completar o checkout.
2. Após o pagamento, verifique o estado do pagamento e o saldo em Billing. Um redirecionamento de checkout sozinho não é confirmação.
3. Compare o uso de tarefas salvas com o mesmo intervalo de data e fontes da conta. Outras chaves podem gastar com esse saldo também.

- [Billing e faturas](https://flashdata.dev/app/billing)
- [Monitore o uso da conta](https://flashdata.dev/pt/docs/guides/usage-and-limits/reference.md#usage)

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

## Se os números não corresponderem

Um saldo ou preço lido não reserva créditos. Verifique o uso real da consulta, outras atividades de conta e trabalho em voo. Resumos de uso podem ficar atrás de recentes consultas ou reembolsos, comparar o mesmo intervalo de tempo e permissões de origem. No 402, pause o trabalho e reveja o equilíbrio em vez de criar outro teste.

