浏览文档
开始使用
查看请求价格、余额可用次数,以及如何补充 Credits。
本页内容
如何计费
| 操作 | 计费依据 |
|---|---|
| Google 搜索 / YouTube 数据 | 按请求计费。每个分页或批量项目算一次请求,搜索结果条数不算。 |
| YouTube 下载 | 按交付到存储的字节计费。 |
| 余额、价格、限额与用量读取 | 不消耗查询 Credits,仍受读取限流约束。 |
检查余额与价格
在控制台打开 Billing,或运行下方免费检查。本例估算五次 Google 搜索请求,不提交搜索。
使用 CLI 已保存的访问。使用命名配置时,在每条命令后追加 --profile NAME。这些读取不消耗查询 Credits。
flashdata account balance
flashdata account pricing --source google_search --request-count 5需要 Bash 与 cURL 7.76+。若环境已提供 FLASHDATA_API_KEY,跳过隐藏输入提示。在同一终端运行读取命令。
# 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'
)若已设置 FLASHDATA_API_KEY,跳过隐藏输入提示。在同一终端运行读取命令。
# 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
}读取估算
使用余额中的 availableCredits。定价中要求 available: true,并读取 estimatedCredits。CLI JSON 将账户响应包装在 data 中。以下价格仅为示例,使用账户实际返回值。
{
"requestCount": 5,
"prices": [
{
"source": "google_search",
"available": true,
"creditsPerRequest": 0.02,
"estimatedCredits": 0.1
}
]
}1 Credit 能请求多少次?
单次搜索为 0.02 Credits 时,1 Credit 最多支持 50 次 Google 搜索;单次元数据请求为 0.01 Credits 时,最多支持 100 次 YouTube 元数据请求。这是同一余额的不同用法,估算时使用实际返回价格。
| 示例任务 | 成本 | 剩余 |
|---|---|---|
| 50 次 Google 搜索 | 50 × 0.02 = 1 Credit | 0 Credits |
| 100 次 YouTube 元数据请求 | 100 × 0.01 = 1 Credit | 0 Credits |
| 20 次 Google 搜索 + 30 次元数据请求 | 0.4 + 0.3 = 0.7 Credits | 0.3 Credits |
task cost = request count × creditsPerRequest
affordable requests = floor(availableCredits ÷ creditsPerRequest)YouTube 下载按字节计费
具有 youtube_download 权限时,读取 creditsPerTb 和 bytesPerUnit。成本 = 交付字节 ÷ bytesPerUnit × creditsPerTb。estimatedCredits 为 null,因为请求次数无法预测交付字节。
flashdata account pricing --source youtube_download认领后的 Credits
凭据交接后检查所有者余额。批准允许智能体使用共享余额,不会购买 Credits、授权结账或建立独立智能体消费上限。
| 阶段 | 使用哪份余额? |
|---|---|
| 临时试用 | 临时身份自己的限时试用余额,仅限可试用来源。 |
| 已有账户认领 | 后续请求使用所有者共享余额,未用完试用 Credits 不会转移。 |
| 新注册后认领 | 按正常注册资格处理,认领不会额外增加一份注册额度。 |
补充 Credits
- 在 Billing 中审核套餐或充值、总价及续订条款,再完成结账。
- 付款后在 Billing 检查支付状态和余额,不要仅凭结账返回判断成功。
- 以相同账户日期范围和来源,核对已保存任务用量。其他密钥也可能消耗此余额。
数字不一致时
读取余额或价格不会预留 Credits。检查实际查询用量、其他账户活动及处理中工作。用量汇总可能晚于近期查询或退款;核对相同时段及来源权限。遇到 402 时暂停并检查余额,不要创建新试用。