Explorar documentación
Primeros pasos
Comprueba el acceso, corrige una solicitud fallida o resuelve tus dudas sobre FlashData.
En esta página
Comience con un cheque de acceso gratuito
Ejecute el cheque donde la tarea falló. Utilice sus credenciales existentes; estos comandos no envían una consulta.
Utilice su acceso CLI guardado. Para un perfil llamado, anexa --profile NAME a cada comando. Estas lecturas no gastan créditos de consulta.
flashdata --version
flashdata doctor --offline
flashdata auth status --jsonUtilice el FLASHDATA_API_KEY existente en la misma terminal, contenedor o trabajo programado. Requiere 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'
)Utilice el FLASHDATA_API_KEY existente en la misma terminal, contenedor o trabajo programado.
& {
$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
}Qué comprobar
La identidad debe tener access: ready e incluir su fuente en los alcances. En CLI JSON, la identidad está en data.identity.identity; también requiere data.accessVerified: verdadero. Un comando exitoso con accessVerified: falso no ha verificado el acceso.
Para un perfil CLI llamado, anexa --profile NAME a cada comando a continuación. Mantenga el usuario original --state-dir y OS. FLASHDATA_API_KEY anula una tecla CLI guardada; los hosts SDK y MCP utilizan su propia configuración credenciales.
Encontrar y arreglar el problema
Abra el síntoma que coincida con su error. Utilice IDs y los recibos de la tarea original.
Comando no encontrado o falta perfil
No ejecutable: instalar el lanzamiento para su OS/CPU y añadir su directorio a PATH. Perfil de desaparecido: utilice el directorio original de usuario y estado OS. Compruebe dentro del programador o contenedor, también.
command -v flashdata
flashdata --version
flashdata doctor --offlineGet-Command flashdata
flashdata --version
flashdata doctor --offline401 / 403: llave, alcance o expiración
Para reemplazar una llave de propietario guardada, pega la clave aprobada en el impulso oculto. Si FLASHDATA_API_KEY está establecido, actualice ese secreto en el tiempo de ejecución en lugar; guardar otra tecla CLI no la anulará.
- 401: verifique una clave caducada, revocada o configurada incorrectamente. 403: compare la fuente solicitada con los alcances de la identidad.
- Los REST y SDK usan X-API-Key. Un MCP OAuth no puede reemplazar una tecla API. Para el acceso temporal, utilice la recuperación de la reclamación a continuación.
flashdata auth login --replace
flashdata auth status --jsonClaim approved, but the agent still has trial access
Terminar la entrega en el mismo perfil CLI que creó la reclamación. El propietario completa la inscripción, verificación de correo electrónico y consentimiento en el navegador; el CLI recibe la credenciales.
flashdata auth finish --wait --timeout 10m
flashdata auth status --jsonSolicita otro enlace para la prueba existente, espera a que el titular apruebe y ejecuta auth finish. No vuelvas a ejecutar init.
flashdata auth claim402: créditos insuficientes
Compara availableCredits con el precio actual de la fuente. Vincula una prueba agotada para usar el saldo del titular, o pide al titular que revise Billing antes de reintentar.
Utilice su acceso CLI guardado. Para un perfil llamado, anexa --profile NAME a cada comando. Estas lecturas no gastan créditos de consulta.
flashdata account balance
flashdata account pricing --source google_search --request-count 1Utilice el FLASHDATA_API_KEY existente en la misma terminal, contenedor o trabajo programado. Requiere 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'
)Utilice el FLASHDATA_API_KEY existente en la misma terminal, contenedor o trabajo programado.
& {
$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: espera antes de reintentar
Lea Retry-After sobre la respuesta fallida: segundos o una fecha HTTP. Espere hasta entonces y reduzca la concurrencia. El registro de pruebas permite tres registros por IP por ventana 24-hour; reutiliza el perfil original y la prueba de registro.
Esta lectura gratuita muestra los encabezados de ahorro, estado y cuerpo. Use el Retry-After de la operación que falló; los límites de consulta, registro y lectura de cuenta pueden diferir.
# 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: Error de entrada o procesamiento rechazado
Lea el código, el detalle y fieldErrors del error HTTP. Corrija el cuerpo de solicitud, ahorrelo como request.json, y luego validarlo. Mantenga las credenciales de almacenamiento en un archivo de entrada privado. Si 422 viene de un resultado de trabajo existente, inspeccione job.error primero.
flashdata query --input request.json --mode async --dry-run --jsonTrabajo pendiente, o HTTP 200 con un trabajo fallido
Lea el trabajo desde submission.json, tu recibo de asinc guardado. HTTP 200 significa que el estado leído tuvo éxito; job.status es el resultado de la tarea (data.status en CLI JSON). Para Batch, excepto la entrada pertinente de las consultas como submission.json.
| Estado o error | Siguiente acción |
|---|---|
| pending / processing | Espera en el mismo trabajo; no lo vuelvas a presentar. |
| completed | Busque y guarde el resultado existente. |
| failed | Inspeccione job.error antes de enviar el trabajo corregido. |
| 404 | Compruebe el trabajo ID y la cuenta de envío. |
| 409 | Los resultados no están listos. Sigue encuestando el mismo trabajo. |
| 410 | JSON almacenado caducó después de las horas 24. Utilice su copia guardada; los medios entregados tiene su propia retención de almacenamiento. |
# 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
)Timeout / 5xx: ¿fue aceptada la tarea?
Inspeccione la carrera original e Historia antes de reintentar un POST. Recuperar un trabajo confirmado aceptado. Si la aceptación es desconocida, mantenga la ID y soporte de contacto; cambiar IDs y volver a presentar puede duplicar los cargos.
flashdata runs show RUN_IDflashdata runs recover RUN_IDCLI output_exists: archivo de resultado ya existe
El CLI no sobrescribe archivos --output. Lea el archivo existente, o elija un nuevo nombre de archivo de salida mientras mantiene el --run-id original y solicite. No invente un nuevo ID ejecutar para evitar este error.
flashdata runs show RUN_IDBúsqueda vacía, subtítulos perdidos o descarga no legible
Estos comandos sólo leen los archivos de resultados locales, no el sobre stdout de CLI.
Si el estado se hace y orgánico está vacío, se sueltan filtros de consulta. Mantenga el resultado vacío en su registro de tareas.
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.jsonLos metadatos enumeran códigos de idioma, no si una pista es manual o automática. Elija un idioma listado y establezca auto explícitamente: verdadero para automático, falso para manual. Ninguna pista de emparejamiento significa que no hay leyendas para esa selección; FlashData no genera un reemplazo.
jq '.results[0].transcriptLanguages' metadata.jsonLea el recibo delivery.json completado. Descargue el objeto con sus credenciales de almacenamiento de destino, luego compare su tamaño y MD5 con el recibo. Un file_url privado no se hace público después de la entrega.
jq '.results[0] | {file_url, file_size, md5}' delivery.jsonMCP herramientas faltantes o autenticación caducado
Comprueba el host ejecutando la tarea. Un servidor listado confirma la configuración, no una conexión de trabajo. Si la conexión OAuth configurada requiere iniciar sesión, ejecutar su comando de inicio de sesión y completar la aprobación del navegador, luego refresca la lista de herramientas.
Abra /mcp en el Codex CLI para comprobar el estado de conexión y las herramientas. En la aplicación, compruebe el servidor configurado y comience una sesión nueva después de los cambios de configuración.
codex mcp listcodex mcp login flashdata --scopes mcp:researchopenclaw mcp doctor flashdata --probeopenclaw mcp login flashdata
openclaw mcp doctor flashdata --probeEl login OAuth no repara una conexión API-key. Compruebe la clave en el entorno del host y sus permisos de origen. Para stdio local, compruebe el requisito MCP del paquete Node.js y reinicie el host después de actualizar su entorno.
node --versionHabilidad instalada pero el agente no puede encontrarla o utilizarla
Compruebe el mismo proyecto, perfil de host e instalar la ubicación, a continuación, iniciar una sesión de agente fresco. Las habilidades de tarea CLI necesitan el CLI; flashdata-mcp necesita un servidor MCP conectado. Instalar una habilidad no conecta un servidor o otorgar permisos de cuenta.
flashdata skills verify --agent codexflashdata skills verify --agent codex --skill flashdata-mcpopenclaw skills list --eligible
openclaw skills checkPreguntas frecuentes
Cómo conectarse
¿Necesito un agente de inteligencia artificial?
No. Utilice el HTTP API, Go/Python/TypeScript SDK, CLI o consola directamente. MCP y las habilidades son opciones adicionales para los agentes.
¿Qué interfaz debería elegir?
Usar un SDK o HTTP API dentro de una aplicación, la CLI para tareas terminales, y MCP para una MCP- un huésped capaz. Las habilidades proporcionan instrucciones para cualquiera CLI tareas o conectados MCP herramientas; no reemplazan la autenticación.
¿Puedo reutilizar las credenciales para tareas recurrentes?
Sí. Utilice el acceso del propietario y preservar el mismo perfil protegido CLI, secreto de tiempo de ejecución o conexión MCP. Para el acceso API-key, consulte recurringAllowed: verdadero. Su host o programador ejecuta el horario.
¿Elimina los ajustes locales revocar el acceso?
No. Revoque la tecla API o la conexión en la consola. Eliminar la configuración local sólo elimina esa copia local.
Pruebas y créditos
¿Puede un agente probar FlashData antes de registrarse?
Sí, con acceso temporal elegible a través de CLI o a bordo API. Reutilizar el mismo perfil y prueba de registro. API llave.
¿Vincular una prueba concede más créditos de prueba?
La vinculación por sí sola no concede créditos de prueba adicionales. Las solicitudes futuras usan el saldo de la cuenta del titular; los créditos temporales sin usar no se transfieren. Una cuenta nueva sigue la política normal de créditos del registro.
¿Cuántas solicitudes pueden cubrir mis créditos?
Compruebe el equilibrio de cuenta y los precios de origen. La solicitud cuenta depende de la fuente, y las tareas de fuente mixta comparten un equilibrio. YouTube Download es precio por bytes descargados, no un recuento de solicitud fijo.
Fuentes y resultados
¿Por qué mi agente puede buscar pero no descargar?
Descargue el acceso del propietario, el permiso de youtube_download y el almacenamiento de destino. Ensayos temporales y mcp:Investigación OAuth no incluyen Descarga. Una llave del propietario autorizado API puede utilizarlo a través de CLI, HTTP o MCP.
¿Vive Google Search devuelve páginas web completas?
Devuelve los resultados de búsqueda y extractos. Su aplicación o agente lee el URLs seleccionado.
¿FlashData genera resúmenes o capciones de vídeo?
Recupera metadatos y leyendas existentes. No genera capciones perdidas; su modelo escribe un resumen de los resultados disponibles.
¿Todavía está atascado?
Guardar el HTTP cuerpo de error o CLI JSON error de stderr como diagnostic.json. Extraer identificadores sólo después de un comando fallido. Mantener llaves, texto de consulta privada y firmado URLs fuera del informe, por no-JSON respuestas, informen sobre HTTP Estado de la situación 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 de la UTC:
Cliente + versión:
Fuente + etapa (auth / submit / poll / fetch):
HTTP estado + código de error:
Solicitud ID / trabajo ID / ejecutar ID:
Resultado de la presentación: aceptado / rechazado / desconocido
Resultado previsto vs real: