Explorar documentação
Primeiros passos
Veja o que custa um pedido, até onde vai o seu saldo e como adicionar créditos.
Nesta página
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. |
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.
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.
flashdata account balance
flashdata account pricing --source google_search --request-count 5Requer 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.
# 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'
)Pule o prompt de chave escondida se FLASHDATA_API_KEY já está definido. Execute os comandos de leitura no mesmo 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
}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.
{
"requestCount": 5,
"prices": [
{
"source": "google_search",
"available": true,
"creditsPerRequest": 0.02,
"estimatedCredits": 0.1
}
]
}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 |
Custo da tarefa = contagem de pedidos × creditsPerRequest
Pedidos acessíveis = andar(availableCredits ÷ creditsPerRequest)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.
flashdata account pricing --source youtube_downloadCré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. |
Adicione créditos
- Em Billing, reveja o plano ou os termos, total e renovação antes de completar o checkout.
- Após o pagamento, verifique o estado do pagamento e o saldo em Billing. Um redirecionamento de checkout sozinho não é confirmação.
- 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.
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.