Перейти к содержимому
RU
Ключ API
Обзор документации

Начало работы

Вопросы и устранение неполадок

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

На этой странице

Начните с бесплатной проверки доступа

Проверь, где не получилось выполнить задание. Используйте его существующие учетные данные; эти команды не отправляют запрос.

Используйте сохраненный доступ CLI. Для именованного профиля добавьте имя --profile к каждой команде. Эти чтения не тратят кредиты на запросы.

Бесплатный аккаунт читать
flashdata --version
flashdata doctor --offline
flashdata auth status --json

Что проверить

Идентификатор должен иметь 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 --offline

401 / 403: ключ, объем или срок действия

Чтобы заменить сохраненный ключ владельца, вставьте одобренный ключ в скрытую подсказку. Если FLASHDATA_API_KEY установлен, обновите этот секрет во время выполнения; сохранение другого ключа CLI не переопределит его.

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

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

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

Используйте сохраненный доступ CLI. Для именованного профиля добавьте имя --profile к каждой команде. Эти чтения не тратят кредиты на запросы.

Бесплатный аккаунт читать
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, а затем проверьте его. Держите 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
# 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

Пустой поиск, недостающие подписи или нечитаемые загрузки

Эти команды читают только локальные файлы результатов, а не только CLI? stdout конверт.

Инструменты MCP отсутствуют или срок аутентификации истек

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

Откройте /mcp в Codex CLI для проверки состояния соединения и инструментов. В приложении проверьте настроенный сервер и начните новый сеанс после изменения настройки.

Проверьте конфигурацию
codex mcp list
Только когда требуется вход OAuth
codex mcp login flashdata --scopes mcp:research

Навык установлен, но агент не может найти или использовать его.

Проверьте тот же проект, профиль хоста и место установки, а затем начните новую сессию агента. Навыки выполнения задач CLI нужны CLI; Flashdata-mcp нужен подключенный сервер MCP. Установка навыка не подключает сервер или не предоставляет разрешения на учетную запись.

Проверьте набор навыков CLI по умолчанию
flashdata skills verify --agent codex

Часто задаваемые вопросы

Подключение

Нужен ли мне ИИ-агент?

Нет. Используйте 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:
Клиент + версия:
Источник + этап (auth / submit / poll / fetch):
HTTP статус + код ошибки:
Запросить ID / задание ID / запустить ID:
Результаты представления: принято/отклонено/неизвестно
Ожидаемый результат против фактического: