Pular para o conteúdo
PT
Obter chave API
Explorar documentação

Primeiros passos

Perguntas frequentes e solução de problemas

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.

Conta livre lê
flashdata --version
flashdata doctor --offline
flashdata auth status --json

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.

Localize o executável
command -v flashdata
flashdata --version
flashdata doctor --offline

401 / 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.

  1. 401 Verifique se a chave está vencida, revogada ou incorretamente configurada. 403Compare a fonte solicitada com o escopo da identidade.
  2. 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.
Substitua e verifique uma chave de dono salva
flashdata auth login --replace
flashdata auth status --json

vinculaçã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.

Termine e verifique
flashdata auth finish --wait --timeout 10m
flashdata auth status --json

402- 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.

Conta livre lê
flashdata account balance
flashdata account pricing --source google_search --request-count 1

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.

Capture a resposta! 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
)
Inspecione a capacidade da conta
flashdata account limits

400 / 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.

Validar sem uma submissão paga
flashdata query --input request.json --mode async --dry-run --json

Trabalho 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 erroPróxima ação
pending / processingEspere no mesmo trabalho, não o submeta novamente.
completedBusque e salve o resultado existente.
failedInspecione job.error antes de enviar o trabalho corrigido.
404Verifique o trabalho ID e a conta de submissão.
409Os resultados não estão prontos. Continue pesquisando o mesmo trabalho.
410JSON expirado após as horas de 24. Use sua cópia salva, a mídia entregue tem sua própria retenção de armazenamento.
Inspecione o trabalho salvo. 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
)
Ainda correndo, use o JOB_ID de volta
flashdata jobs wait JOB_ID
Concluído · use um novo nome de arquivo de saída
flashdata jobs result JOB_ID --output recovered-result.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.

Inspecione primeiro · substituir RUN_ID
flashdata runs show RUN_ID
Recupere o trabalho confirmado e aceite
flashdata runs recover RUN_ID

CLI 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.

Inspecione a corrida original
flashdata runs show RUN_ID

Busca vazia, legendas perdidas ou download ilegível

Esses comandos só lêem arquivos de resultados locais, não o envelope do CLI.

MCP 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.

Verifique a configuração
codex mcp list
Só quando o login do OAuth é necessário
codex mcp login flashdata --scopes mcp:research

Habilidade 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.

Verifique o pacote de habilidades padrão CLI
flashdata skills verify --agent codex

Perguntas 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.

Capturar um livre CLI Checagem de acesso. Bash
flashdata auth status --json 2> diagnostic.json
Extrair identificadores de erro · 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
Relatório de apoio
Hora 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: