Обзор документации
Начало работы
Посмотрите, сколько стоит запрос, как далеко идет ваш баланс и как добавить кредиты.
На этой странице
Как оплачивается использование
| Работа | База данных Billing |
|---|---|
| Google Search / YouTube Data | По запросу. Каждая страница или пакетный элемент - это запрос; поисковые хиты - нет. |
| YouTube Download | Пер байт доставляется на хранение. |
| Баланс, цены, ограничения и использование | Никаких запросов. Ограничения по чтению все еще действуют. |
Проверьте баланс и цены
Используйте Billing в консоли или запустите эти бесплатные проверки. В этом примере цены пять запросов Google Search без их отправки.
Используйте сохраненный доступ CLI. Для именованного профиля добавьте имя --profile к каждой команде. Эти чтения не тратят кредиты на запросы.
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 оборачивает каждый ответ учетной записи в данные. Следующая цена является иллюстративной; используйте стоимость, возвращенную для вашего счета.
{
"requestCount": 5,
"prices": [
{
"source": "google_search",
"available": true,
"creditsPerRequest": 0.02,
"estimatedCredits": 0.1
}
]
}Сколько запросов по кредиту 1?
При использовании кредитов 0.02 для каждого поиска кредит 1 покрывает поиск 50 Google. При запросе 0.01 на метаданные он покрывает запросы 100 YouTube Metadata. Это альтернативные варианты использования одного баланса; используйте возвращенные цены при оценке.
| Примерная рабочая нагрузка | Стоимость | оставаться |
|---|---|---|
| 50 Google Поиск | 50 × 0.02 = 1 кредит | Кредиты 0 |
| Запросы 100 YouTube Metadata | 100 × 0.01 = 1 кредит | Кредиты 0 |
| 20 Google поиск + запросы метаданных 30 | 0.4 + 0.3 = 0.7 кредиты | Кредиты 0.3 |
Стоимость задачи = количество запросов × creditsPerRequest
Доступные запросы = пол (availableCredits ÷ creditsPerRequest)YouTube Download использует байты
С разрешения youtube_download читайте creditsPerTb и bytesPerUnit. Стоимость = доставленные байты ÷ bytesPerUnit × creditsPerTb. estimatedCredits - это null, потому что количество запросов не может предсказать доставленные байты.
flashdata account pricing --source youtube_downloadКредиты после предъявления
Проверьте баланс владельца после передачи учетных данных. Одобрение позволяет агенту тратить этот общий баланс; он не покупает кредиты, не разрешает оформление заказа или не создает отдельного лимита расходов на одного агента.
| этап | Какой баланс оплачивается? |
|---|---|
| Временный суд | Собственный ограниченный по времени пробный баланс для соответствующих источников. |
| Заявлено по существующему счету | Будущие запросы используют общий баланс владельца. Неиспользованные пробные кредиты не передаются. |
| Заявлено после новой регистрации | Нормальное право на регистрацию применяется. Заявка не добавляет еще одного кредитного гранта. |
Добавить кредиты
- В Billing просмотрите план или условия пополнения, полного и продления до завершения оформления заказа.
- После оплаты проверьте статус оплаты и баланс в Billing. Одно только перенаправление заказа не является подтверждением.
- Сравните использование сохраненных задач с тем же диапазоном дат и источников. Другие ключи также могут быть потрачены с этого баланса.
Если цифры не совпадают
Счет баланса или цены не резервирует кредиты. Проверьте фактическое использование запроса, другую активность учетной записи и работу в полете. Резюме использования могут отставать от последних запросов или возвратов; сравните тот же временной диапазон и разрешения источника. На 402 приостановите работу и пересмотрите баланс, вместо того, чтобы создавать еще одно испытание.