Explorar documentação
Primeiros passos
Verifique seu acesso, conserte um pedido fracassado ou encontre uma resposta sobre usar FlashData.
Nesta página
Comece com um verificação de acesso gratuito
Verifique onde a tarefa falhou. Use suas credenciais existentes, esses comandos não enviam uma consulta.
Use seu acesso CLI salvo. Para um perfil nomeado, adicione o nome --profile a cada comando. Essas leituras não gastam créditos de consulta.
flashdata --version
flashdata doctor --offline
flashdata auth status --jsonUse o FLASHDATA_API_KEY existente no mesmo terminal, container ou trabalho agendado. Requer 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'
)Use o FLASHDATA_API_KEY existente no mesmo terminal, container ou trabalho agendado.
& {
$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
}O que verificar?
A identidade deve ter access: ready e incluir sua fonte em escopos. Em CLI JSON, a identidade está em data.identity.identity; também requer data.accessVerified: true. Um comando bem sucedido com accessVerified: false não verificou o acesso.
Para um perfil chamado CLI, adicione --profile Nome a cada comando abaixo. Mantenha o --state-dir original e o OS usuário. FLASHDATA_API_KEY substitui uma chave salva CLI; SDKs e anfitriões MCP usam sua própria configuração credencial.
Encontre e conserte o problema
Abra o sintoma que bate com o seu erro. Use IDs e recibos da tarefa original.
Comando não encontrado ou perfil faltando
Sem executável: instale o lançamento do seu OS/CPU e adicione seu diretório ao PATH. Perfil em falta: use o usuário OS original e diretório de estado. Verifique dentro do agendador ou recipiente, também.
command -v flashdata
flashdata --version
flashdata doctor --offlineGet-Command flashdata
flashdata --version
flashdata doctor --offline401 / 403: chave, escopo ou validade
Para substituir uma chave de dono salva, cole a chave aprovada no prompt escondido. Se o FLASHDATA_API_KEY estiver definido, atualize esse segredo no tempo de execução; salvar outra chave CLI não irá sobrepor.
- 401 Verifique se a chave está vencida, revogada ou incorretamente configurada. 403Compare a fonte solicitada com o escopo da identidade.
- REST e SDKs usam X-API-Key. Um símbolo MCP OAuth não pode substituir uma chave API. Para acesso temporário, use a cobrança abaixo.
flashdata auth login --replace
flashdata auth status --jsonvinculação aprovada, mas o agente ainda tem acesso a teste.
Termine a entrega no mesmo perfil CLI que criou a vinculação. O proprietário completa a inscrição, verificação por e-mail e consentimento no navegador, o CLI recebe a credencial.
flashdata auth finish --wait --timeout 10m
flashdata auth status --jsonPeça um novo link para o teste existente, deixe o proprietário aprovar, e então execute auth finish. Não execute init novamente.
flashdata auth claim402- Créditos insuficientes
Compare availableCredits com o preço atual para sua fonte. Reivindicar um teste esgotado para usar o equilíbrio do proprietário, ou deixar o proprietário rever Billing antes de tentar novamente.
Use seu acesso CLI salvo. Para um perfil nomeado, adicione o nome --profile a cada comando. Essas leituras não gastam créditos de consulta.
flashdata account balance
flashdata account pricing --source google_search --request-count 1Use o FLASHDATA_API_KEY existente no mesmo terminal, container ou trabalho agendado. Requer 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'
)Use o FLASHDATA_API_KEY existente no mesmo terminal, container ou trabalho agendado.
& {
$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 Espere antes de tentar novamente
Leia Retry-After na resposta falhada: segundos ou uma data HTTP. Espere até lá e reduza a concorrência. O registro de teste permite três registros por IP por janela 24-hora, reutilizar o perfil original e a prova de registro.
Esta leitura gratuita demonstra salvar cabeçalhos, status e corpo. Use o Retry-After da operação que falhou; consulta, registro e limites de leitura de conta podem ser diferentes.
# 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: entrada ou falha de processamento rejeitada
Código de leitura, detalhes e fieldErrors do erro HTTP. Corrija o corpo do pedido, guarde-o como request.json, então valide-o. Mantenha as credenciais de armazenamento em um arquivo privado. Se 422 vem de um trabalho existente, inspecione job.error primeiro.
flashdata query --input request.json --mode async --dry-run --jsonTrabalho pendente, ou HTTP 200 com um trabalho fracassado
Leia o trabalho do submission.json, seu recibo salvo. HTTP 200 significa que o status lido foi bem sucedido; job.status é o resultado da tarefa (data.status em CLI JSON). Para Batch, salve a entrada relevante de consultas como submission.json.
| Estado ou erro | Próxima ação |
|---|---|
| pending / processing | Espere no mesmo trabalho, não o submeta novamente. |
| completed | Busque e salve o resultado existente. |
| failed | Inspecione job.error antes de enviar o trabalho corrigido. |
| 404 | Verifique o trabalho ID e a conta de submissão. |
| 409 | Os resultados não estão prontos. Continue pesquisando o mesmo trabalho. |
| 410 | JSON expirado após as horas de 24. Use sua cópia salva, a mídia entregue tem sua própria retenção de armazenamento. |
# 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
)Tempo limite / 5xx: a tarefa foi aceita?
Inspecione a corrida original e History antes de tentar novamente um POST. Recupere um trabalho aceito. Se a aceitação for desconhecida, mantenha o controle ID e o suporte de contato, mudar IDs e reenviar pode duplicar as cargas.
flashdata runs show RUN_IDflashdata runs recover RUN_IDCLI output_exists: arquivo de resultados já existe
O CLI não substitui arquivos --output. Leia o arquivo existente, ou escolha um novo nome de saída enquanto mantém o --run-id original e solicita. Não invente uma nova corrida ID para contornar esse erro.
flashdata runs show RUN_IDBusca vazia, legendas perdidas ou download ilegível
Esses comandos só lêem arquivos de resultados locais, não o envelope do CLI.
Se o status for feito e o orgânico estiver vazio, solte os filtros de consulta. Mantenha o resultado vazio em seu registro de tarefas.
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.jsonMetadados listam códigos de linguagem, não se uma faixa é manual ou automática. Escolha um idioma listado e ajuste o explicitly: true automático, false manual. Nenhuma pista correspondente significa nenhuma legenda para essa seleção; FlashData não gera uma substituição.
jq '.results[0].transcriptLanguages' metadata.jsonLeia o recibo delivery.json completo. Baixe o objeto com suas credenciais de armazenamento de destino, e compare seu tamanho e MD5 com o recibo. Um file_url privado não se torna público após a entrega.
jq '.results[0] | {file_url, file_size, md5}' delivery.jsonMCP ferramentas faltando ou autenticação expirada
Verifique o anfitrião executando a tarefa. Um servidor listado confirma a configuração, não uma conexão funcional. Se a conexão OAuth configurada requer login, execute seu comando de login e complete a aprovação do navegador, então atualize a lista de ferramentas.
Abra /mcp no Codex CLI para verificar o status da conexão e ferramentas. No aplicativo, verifique o servidor configurado e comece uma nova sessão após as mudanças de configuração.
codex mcp listcodex mcp login flashdata --scopes mcp:researchopenclaw mcp doctor flashdata --probeopenclaw mcp login flashdata
openclaw mcp doctor flashdata --probeO login do OAuth não repara uma conexão API-key. Verifique a chave no ambiente do hospedeiro e suas permissões de origem. Para a Stdio local, verifique o requisito MCP do pacote Node.js e reinicie o host após atualizar seu ambiente.
node --versionHabilidade instalada, mas o agente não pode encontrá-la ou usá-la.
Verifique o mesmo projeto, perfil do host e instale o local, e comece uma nova sessão de agentes. As habilidades de tarefa CLI precisam do CLI; flashdata-mcp precisa de um servidor MCP conectado. Instalar uma habilidade não conecta um servidor ou concede permissões de conta.
flashdata skills verify --agent codexflashdata skills verify --agent codex --skill flashdata-mcpopenclaw skills list --eligible
openclaw skills checkPerguntas frequentes
Se conectando
Preciso de um agente de IA?
Não. Use HTTP API, Go/Python/TypeScript SDK, CLI ou console diretamente. MCP e habilidades são opções adicionais para agentes.
Qual interface devo escolher?
Use um SDK ou HTTP API dentro de um aplicativo, o CLI para tarefas terminais, e MCP para um hospedeiro com capacidade para MCP. Habilidades fornecem instruções para tarefas CLI ou ferramentas MCP conectadas; elas não substituem a autenticação.
Posso reutilizar credenciais para tarefas recorrentes?
Sim. Use o acesso do proprietário e mantenha o mesmo perfil protegido CLI, segredo de execução ou conexão MCP. Para acesso chave API, verifique recurringAllowed: true. Seu anfitrião ou agendador executa a programação.
Apagar as configurações locais revoga o acesso?
Não. Revogue a chave API ou conexão no console. Excluir as configurações locais só remove essa cópia local.
testes e créditos
Um agente pode tentar FlashData antes de se inscrever?
Sim, com acesso temporário elegível através do CLI ou a bordo do API. Reutilize o mesmo perfil e a mesma prova de registro. Necessidades de uso contínuo ou uma chave API existente.
Alegando adicionar outra bolsa para teste?
Se reivindicar não dá créditos extras. Pedidos futuros usam o saldo da conta do proprietário, créditos temporários não usados não são transferidos. Uma conta recém-criada segue a política normal de inscrição-crédito.
Quantos pedidos meus créditos podem cobrir?
Verifique o saldo da conta e o preço da fonte. A contagem de pedidos depende da fonte, e tarefas mistas compartilham um equilíbrio. YouTube Download é pago por bytes baixados, não uma contagem fixa de pedidos.
Fontes e resultados
Por que meu agente pode procurar, mas não baixar?
O download precisa de acesso ao proprietário, permissão youtube_download e armazenamento de destino. Testes temporários e mcp:research OAuth não incluem download. Uma chave API autorizada pode usá-la através de CLI, HTTP ou MCP.
Google Search retorna todas as páginas da web?
Ele retorna resultados de busca e trechos. Seu aplicativo ou agente lê o URLs selecionado.
FlashData gera resumos de vídeo ou legendas?
Recupera metadados e legendas existentes. Não gera legendas faltando, seu modelo escreve um resumo dos resultados disponíveis.
Ainda preso? Envie um relatório mínimo
Salve o corpo de erro HTTP ou o erro CLI JSON de stderr como diagnostic.json. Extrair identificadores apenas após um comando falhado. Mantenha as chaves, texto de consulta privada e assinou URLs fora do relatório. Para respostas não JSON, reporte o status HTTP de 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.jsonHora da UTC:
Cliente + versão:
Fonte + fase (auth / enviar / votação / buscar):
HTTP status + código de erro:
Solicitar ID / trabalho ID / execução ID:
Resultado da submissão: aceito/rejeitado/desconhecido
Espera-se contra o resultado real: