Перейти до вмісту
UK
Отримати ключ API
Переглянути документацію

Початок роботи

Запитання й усунення несправностей

Перевірити свій доступ, зафіксувати невдалий запит або знайти відповідь про використання FlashData.

На цій сторінці

Почати з безкоштовною перевіркою доступу

Виконайте перевірку, в якому завдання не вдалося. Використовуйте наявні дані; ці команди не подають запиту.

Використовуйте ваш збережений CLI access. Для названого профілю, Додаток --profile NAME до кожного команди. Ці дані не витрачають на запити.

Безкоштовні читання облікового запису
flashdata --version
flashdata doctor --offline
flashdata auth status --json

Що потрібно перевірити

У випадку, якщо ви хочете мати 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 --offline

401 / 403: ключ, обсяг або термін дії

Щоб замінити збережений ключ власника, вставте схвалений ключ в приховану підказку. Якщо FLASHDATA_API_KEY встановлено, оновлення, що секрет в режимі runtime замість того, щоб зберегти інший ключ CLI не перейде його.

  1. 401: перевірте, відкликаний або неправильно налаштований ключ. 403: порівняти джерело запиту з обсягами ідентичності.
  2. 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

402: недостатні кредити

Порівняйте availableCredits з поточною ціною для вашого джерела. Складіть виснажену пробну версію для використання балансу власника, або дайте рецензію власника Billing перед передачею.

Використовуйте ваш збережений CLI access. Для названого профілю, Додаток --profile NAME до кожного команди. Ці дані не витрачають на запити.

Безкоштовні читання облікового запису
flashdata account balance
flashdata account pricing --source google_search --request-count 1

429: чекати до птиху

Читать Retry-After на відмову від відповіді: секунди або дату HTTP. Очікується, поки не знижуйте опуклість. Термінова реєстрація дозволяє три реєстрації на IP за 24-годинне вікно; повторно використовувати оригінальний профіль та реєстраційний доказ.

Цей безкоштовний зчитувач показує збереження заголовків, статусу та тіла. Використовуйте Retry-After з операції, яка не вдалося; запит, реєстрація та ліміти облікового запису можуть відрізнятися.

Захоплення відповіді · Bash / cURL / jq
# 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 limits

400 / 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
# 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
)
Натюрморт · використовувати повернутий JOB_ID
flashdata jobs wait JOB_ID
Завершено · використовувати новий вихідний файл
flashdata jobs result JOB_ID --output recovered-result.json

Час / 5xx: було прийнято завдання?

Перегляньте оригінальний хід і History перед тим, як переробляти POST. Відновити підтверджену роботу. Якщо прийняття невідоме, тримайте запуск ID і контактну підтримку; змініть IDs і відкликання може дублікати зарядів.

Перший Раз · замінити RUN_ID
flashdata runs show RUN_ID
Відновити підтверджену роботу
flashdata runs recover RUN_ID

CLI output_exists: результат файл вже існує

CLI не перезаписує --output файли. Ознайомтеся з існуючим файлом або оберіть нове ім'я вихідного файлу при зберіганні оригінального --run-id та запиту. Не запрошувати новий запуск ID для обходу цієї помилки.

Огляд оригінального запуску
flashdata runs show RUN_ID

Empty search, відсутні підписи або непрочитане завантаження

Ці команди лише прочитали локальні файли результатів, а не CLI's stdout конверт.

MCP інструменти, які відсутні або автентифікації, expired

Перевірити господаря, що веде завдання. Зазначений сервер підтверджує конфігурацію, не робоче підключення. Якщо налаштований розміщений OAuth підключення вимагає логіну, запустіть команду входу та повну схвалення браузера, потім освіжте список інструментів.

Відкрийте /mcp в Codex CLI для перевірки стану з'єднання та інструментів. У додатку перевірте налаштований сервер і запустіть свіжу сеанс після зміни налаштувань.

Перевірити налаштування
codex mcp list
Тільки при реєстрації OAuth обов'язковий
codex mcp login flashdata --scopes mcp:research

Навички встановлюються, але агент не може його використовувати

Перевірити той самий проект, ведучий профіль і встановити місце, після чого почати сеанс свіжого агента. CLI навички задачі потребують CLI; флешdata-mcp потребує підключеного сервера MCP. Встановити майстерність не підключати сервер або надати дозволи на обліковий запис.

Перевірити за замовчуванням CLI навички
flashdata skills verify --agent codex

Часті питання

З'єднання

Чи потрібен агент 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.

Захоплення безкоштовної перевірки доступу CLI · Bash
flashdata auth status --json 2> diagnostic.json
Вимірювачі помилок · Bash / jq
# 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:
Результат дії: прийнятий / відхилений / невідомо
Випробувано проти фактичного результату: