Переглянути документацію
Початок роботи
Перевірити свій доступ, зафіксувати невдалий запит або знайти відповідь про використання FlashData.
На цій сторінці
Почати з безкоштовною перевіркою доступу
Виконайте перевірку, в якому завдання не вдалося. Використовуйте наявні дані; ці команди не подають запиту.
Використовуйте ваш збережений CLI access. Для названого профілю, Додаток --profile NAME до кожного команди. Ці дані не витрачають на запити.
flashdata --version
flashdata doctor --offline
flashdata auth status --jsonВикористовуйте наявну задачу FLASHDATA_API_KEY в одному терміналі, контейнері або запланованій роботі. Вимагає cURL 7.76+.
(
: "${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/identity' || exit
printf '\n'
)Використовуйте наявну задачу FLASHDATA_API_KEY в одному терміналі, контейнері або запланованій роботі.
& {
$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/identity"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}Що потрібно перевірити
У випадку, якщо ви хочете мати access: ready і ввімкніть джерело в обсягах. У CLI JSON, ідентичність знаходиться на data.identity.identity, також вимагають data.accessVerified: true. Успішна команда з accessVerified: false не підтвердила доступ.
Для іменованого профілю CLI, Додаток --profile NAME до кожної команди нижче. Зберігайте оригінальні --state-dir і OS Користувач. FLASHDATA_API_KEY перенадає збережений ключ CLI; SDKs і MCP хостів використовують власну конфігурацію.
Знайти і виправити проблему
Відкрийте симптом, який відповідає вашої помилки. Використовуйте IDs і надходження з оригінального завдання.
Команда не знайдено або не знайдено профілю
Не виконав: встановити реліз для OS/CPU і додати його до PATH. Профіль пропуску: використовуйте оригінальний OS користувача та державного каталогу. Перевірити всередині планувальника або контейнера.
command -v flashdata
flashdata --version
flashdata doctor --offlineGet-Command flashdata
flashdata --version
flashdata doctor --offline401 / 403: ключ, обсяг або термін дії
Щоб замінити збережений ключ власника, вставте схвалений ключ в приховану підказку. Якщо FLASHDATA_API_KEY встановлено, оновлення, що секрет в режимі runtime замість того, щоб зберегти інший ключ CLI не перейде його.
- 401: перевірте, відкликаний або неправильно налаштований ключ. 403: порівняти джерело запиту з обсягами ідентичності.
- REST і SDKs використовують X-API-Key. MCP OAuth не може замінити ключ API. Для тимчасового доступу використовуйте відновлення позову нижче.
flashdata auth login --replace
flashdata auth status --jsonЗатверджено Клайм, але агент все ще має доступ до випробувань
Оздоблення ручної роботи в одному профілі CLI, який створив претензію. Власник завершує реєстрацію, перевірку електронної пошти та згоду в браузері; CLI отримує достовірність.
flashdata auth finish --wait --timeout 10m
flashdata auth status --jsonЗапропонуйте свіжу посилання на існуючу пробну версію, нехай власник затвердить, потім запустіть auth finish. Не запустіть init знову.
flashdata auth claim402: недостатні кредити
Порівняйте availableCredits з поточною ціною для вашого джерела. Складіть виснажену пробну версію для використання балансу власника, або дайте рецензію власника Billing перед передачею.
Використовуйте ваш збережений CLI access. Для названого профілю, Додаток --profile NAME до кожного команди. Ці дані не витрачають на запити.
flashdata account balance
flashdata account pricing --source google_search --request-count 1Використовуйте наявну задачу FLASHDATA_API_KEY в одному терміналі, контейнері або запланованій роботі. Вимагає cURL 7.76+.
(
: "${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=1' || exit
printf '\n'
)Використовуйте наявну задачу FLASHDATA_API_KEY в одному терміналі, контейнері або запланованій роботі.
& {
$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=1"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}429: чекати до птиху
Читать Retry-After на відмову від відповіді: секунди або дату HTTP. Очікується, поки не знижуйте опуклість. Термінова реєстрація дозволяє три реєстрації на IP за 24-годинне вікно; повторно використовувати оригінальний профіль та реєстраційний доказ.
Цей безкоштовний зчитувач показує збереження заголовків, статусу та тіла. Використовуйте Retry-After з операції, яка не вдалося; запит, реєстрація та ліміти облікового запису можуть відрізнятися.
# Bash + cURL + jq. This is a free account read.
(
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
curl --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--dump-header diagnostic-headers.txt --output diagnostic.json \
--write-out '%{http_code}\n' \
'https://api.flashdata.dev/v2/api-access/identity' > diagnostic-status.txt || exit
printf 'HTTP '; cat diagnostic-status.txt
awk 'tolower($1) == "retry-after:" {
$1=""; sub(/^ /, ""); sub(/\r$/, ""); print "Retry-After: " $0
}' diagnostic-headers.txt
if jq -e 'type == "object"' diagnostic.json >/dev/null 2>&1; then
jq '{access, scopes, status, code, requestId}
| with_entries(select(.value != null))' diagnostic.json
else
printf 'Non-JSON response saved in diagnostic.json; check the HTTP status.\n'
fi
)flashdata account limits400 / 422: відхилений вхід або відмова від обробки
Читання коду, деталі та fieldErrors від помилки HTTP. Користь запиту тіла, зберегти його як request.json, потім встановіть його. Збережіть облікові дані для зберігання в приватному вводі. Якщо 422 виходить з наявного результату роботи, перевірте job.error першим.
flashdata query --input request.json --mode async --dry-run --jsonЗакінчення роботи, або HTTP 200 з невдалою роботою
Ознайомтесь з submission.json, Ваш збережений асинхронний чек. HTTP 200 означає, що статус зчитувався вдалося; job.status є результатом завдання (data.status в CLI JSON). Для Batch, зберегти відповідний запис з запитів, як submission.json.
| Стан або помилка | Попередня дія |
|---|---|
| pending / processing | Зачекайте, що в одній роботі не подайте. |
| completed | Захоплення і збереження наявного результату. |
| failed | Інспектор job.error перед поданням виправних робіт. |
| 404 | Перевірити роботу ID і внести обліковий запис. |
| 409 | Результати не готові. Зберігайте опитування однакової роботи. |
| 410 | магазини JSON після закінчення 24 час. Використовуйте збережену копію; доставлені засоби масової інформації мають власний зберігання. |
# Bash + jq. CLI receipts use remoteId; HTTP receipts use id.
(
set -e
JOB_ID=$(jq -er '.remoteId // .id' submission.json)
flashdata jobs get "$JOB_ID" --json
)flashdata jobs wait JOB_IDflashdata jobs result JOB_ID --output recovered-result.json# Bash + cURL + jq. Read the saved async submission receipt.
(
set -e
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
STATUS_URL=$(jq -er '(.submission // .).links[]
| select(.rel == "self") | .href' submission.json)
curl --fail-with-body --silent --show-error --max-time 30 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--header 'Accept: application/json' \
"$STATUS_URL" --output job.json
jq '.job | {id, status, error}' job.json
)Час / 5xx: було прийнято завдання?
Перегляньте оригінальний хід і History перед тим, як переробляти POST. Відновити підтверджену роботу. Якщо прийняття невідоме, тримайте запуск ID і контактну підтримку; змініть IDs і відкликання може дублікати зарядів.
flashdata runs show RUN_IDflashdata runs recover RUN_IDCLI output_exists: результат файл вже існує
CLI не перезаписує --output файли. Ознайомтеся з існуючим файлом або оберіть нове ім'я вихідного файлу при зберіганні оригінального --run-id та запиту. Не запрошувати новий запуск ID для обходу цієї помилки.
flashdata runs show RUN_IDEmpty search, відсутні підписи або непрочитане завантаження
Ці команди лише прочитали локальні файли результатів, а не CLI's stdout конверт.
Якщо статус здійснюється і органічно порожній, прогрітий кварельний фільтр. Зберігайте порожній результат у записі завдань.
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.jsonМетадані списки мовних кодів, не чи є доріжка вручну або автоматична. Виберіть задану мову і встановити автоматичну explicitly: true для автоматичного, false для керівництва. Немає відповідних треків не означає підписки на цей вибір; FlashData не виробляє заміни.
jq '.results[0].transcriptLanguages' metadata.jsonОзнайомтеся з заповненим чеком delivery.json. Завантажте об'єкт з обліковими записами призначення, потім порівняйте його розмір і MD5 з квитанцією. Приватний file_url не є громадськістю після доставки.
jq '.results[0] | {file_url, file_size, md5}' delivery.jsonMCP інструменти, які відсутні або автентифікації, expired
Перевірити господаря, що веде завдання. Зазначений сервер підтверджує конфігурацію, не робоче підключення. Якщо налаштований розміщений OAuth підключення вимагає логіну, запустіть команду входу та повну схвалення браузера, потім освіжте список інструментів.
Відкрийте /mcp в Codex CLI для перевірки стану з'єднання та інструментів. У додатку перевірте налаштований сервер і запустіть свіжу сеанс після зміни налаштувань.
codex mcp listcodex mcp login flashdata --scopes mcp:researchopenclaw mcp doctor flashdata --probeopenclaw mcp login flashdata
openclaw mcp doctor flashdata --probeOAuth Логін не відремонтує API- підключення під ключ. Перевірити ключ в оточенні хосту та його дозволи на джерело. Для місцевих студій перевірте вимогу MCP пакета Node.js і перезавантажте господаря після оновлення його середовища.
node --versionНавички встановлюються, але агент не може його використовувати
Перевірити той самий проект, ведучий профіль і встановити місце, після чого почати сеанс свіжого агента. CLI навички задачі потребують CLI; флешdata-mcp потребує підключеного сервера MCP. Встановити майстерність не підключати сервер або надати дозволи на обліковий запис.
flashdata skills verify --agent codexflashdata skills verify --agent codex --skill flashdata-mcpopenclaw skills list --eligible
openclaw skills checkЧасті питання
З'єднання
Чи потрібен агент AI?
Ні. Використовуйте HTTP API, Go/Python/TypeScript SDK, CLI або консоль безпосередньо. MCP і навички є додатковими варіантами для агентів.
Який інтерфейс повинен вибрати?
Використовуйте SDK або HTTP API всередині програми, CLI для задач терміналу, і MCP для MCP-розвантажувального господаря. Навички дають інструкції щодо виконання завдань CLI або підключених інструментів MCP; не замінюють автентифікацію.
Чи можу я повторно використовувати облікові дані для рецидивних завдань?
Так. Використовуйте доступ власника та зберігайте той же захищений профіль CLI, секрет робочого часу або підключення MCP. Для API-ключ, перевірте recurringAllowed: true. Графік роботи на сайті.
Чи можна видалити локальні налаштування відкликання доступу?
Ні. Відновити ключ API або підключення в консолі. Видалення локальних налаштувань тільки видаляє локальну копію.
Тарифи та кредити
Чи може агент спробувати FlashData перед реєстрацією?
Так, з тимчасовим доступом через CLI або на борту API. Використовуйте той самий профіль і реєстраційний доказ. Неперервне використання вимагає претензій або існуючого власника API ключ.
Чи зажадає додавати інший арбітражний ґрант?
Саме прив’язування не надає додаткових пробних кредитів. Подальші запити використовують баланс облікового запису власника; невикористані тимчасові кредити не переносяться. Для нового облікового запису діє звичайна політика кредитів за реєстрацію.
Скільки запитів може бути кришка моїх кредитів?
Перевірити залишок коштів та початкове ціноутворення. Заявка на кількість запитів залежить від джерела, а також домовленості з використанням одного балансу. YouTube Download за ціною завантаження байтів, не фіксованого підрахунку запитів.
Джерела та результати
Чому ми можемо шукати агента, але не завантажити?
Завантажте доступ до власника, youtube_download дозвіл та сховище призначення. Тимчасові випробування і mcp:research OAuth не включають завантаження. Уповноважений власник API ключ може використовувати його через CLI, HTTP або MCP.
Чи повертає Google Search повноцінні веб-сайти?
Повернути результати пошуку і ліктів. Ваш додаток або агент зчитуває вибраний URLs.
Чи є FlashData генерувати відео підсумки або підписки?
Ви отримуєте метадані та існуючі підписи. Ви не генеруєте відсутні підписи, ваша модель напишіть резюме від доступних результатів.
Натюрморт? Відправити мінімальний звіт
Заощаджуйте HTTP помилки тіла або CLI JSON помилка від stderr як diagnostic.json. Витягувати ідентифікатори тільки після невдалої команди. Зберігати ключі, приватний текст запиту та підписано URLs з звіту. Для не-JSON відгуки, звіт про статус HTTP від diagnostic-status.txt.
flashdata auth status --json 2> diagnostic.json# A saved HTTP error or CLI --json error; local files only.
date -u '+%Y-%m-%dT%H:%M:%SZ'
jq '(.error // .) as $e | {
status: ($e.httpStatus // $e.status),
code: $e.code,
requestId: $e.requestId,
runId: (.runId // $e.runId),
jobId: $e.remoteId,
retryAfter: $e.retryAfter
} | with_entries(select(.value != null))' diagnostic.jsonЧас UTC:
Клієнт + версія:
Джерело + фаза (додаток / подання / опитування / fetch):
HTTP статус + код помилки:
Запит ID / робота ID / запустити ID:
Результат дії: прийнятий / відхилений / невідомо
Випробувано проти фактичного результату: