Обзор документации
Начало работы
Проверьте свой доступ, исправьте неудавшийся запрос или найдите ответ об использовании FlashData.
На этой странице
Начните с бесплатной проверки доступа
Проверь, где не получилось выполнить задание. Используйте его существующие учетные данные; эти команды не отправляют запрос.
Используйте сохраненный доступ CLI. Для именованного профиля добавьте имя --profile к каждой команде. Эти чтения не тратят кредиты на запросы.
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 к каждой команде ниже. Держите оригинального пользователя --state-dir и OS. FLASHDATA_API_KEY переопределяет сохраненный ключ CLI; SDK и хосты 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 установлен, обновите этот секрет во время выполнения; сохранение другого ключа CLI не переопределит его.
- 401: проверьте наличие просроченного, отозванного или неправильно настроенного ключа. 403: сравните запрашиваемый источник с областями идентификации.
- REST и SDK используют 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. Для именованного профиля добавьте имя --profile к каждой команде. Эти чтения не тратят кредиты на запросы.
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, а затем проверьте его. Держите Download учетные данные хранения в частном файле ввода. Если 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_IDПустой поиск, недостающие подписи или нечитаемые загрузки
Эти команды читают только локальные файлы результатов, а не только CLI? 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.jsonИнструменты MCP отсутствуют или срок аутентификации истек
Проверьте хост, выполняющий задание. Перечисленный сервер подтверждает конфигурацию, а не рабочее соединение. Если настроенное хостируемое соединение OAuth требует входа в систему, запуска команды входа в систему и полного одобрения браузера, то обновите список инструментов.
Откройте /mcp в Codex CLI для проверки состояния соединения и инструментов. В приложении проверьте настроенный сервер и начните новый сеанс после изменения настройки.
codex mcp listcodex mcp login flashdata --scopes mcp:researchopenclaw mcp doctor flashdata --probeopenclaw mcp login flashdata
openclaw mcp doctor flashdata --probeЛогин OAuth не восстанавливает соединение API-ключ. Проверьте ключ в среде хоста и его исходные разрешения. Для локального стио проверьте требование Node.js пакета MCP и перезапустите хост после обновления его среды.
node --versionНавык установлен, но агент не может найти или использовать его.
Проверьте тот же проект, профиль хоста и место установки, а затем начните новую сессию агента. Навыки выполнения задач CLI нужны CLI; Flashdata-mcp нужен подключенный сервер MCP. Установка навыка не подключает сервер или не предоставляет разрешения на учетную запись.
flashdata skills verify --agent codexflashdata skills verify --agent codex --skill flashdata-mcpopenclaw skills list --eligible
openclaw skills checkЧасто задаваемые вопросы
Подключение
Нужен ли мне ИИ-агент?
Нет. Используйте 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:
Клиент + версия:
Источник + этап (auth / submit / poll / fetch):
HTTP статус + код ошибки:
Запросить ID / задание ID / запустить ID:
Результаты представления: принято/отклонено/неизвестно
Ожидаемый результат против фактического: