Saltar al contenido
ES
Obtener clave API
Explorar documentación

Primeros pasos

Preguntas frecuentes y solución de problemas

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.

Consultar la cuenta gratis
flashdata --version
flashdata doctor --offline
flashdata auth status --json

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.

Localizar el ejecutable
command -v flashdata
flashdata --version
flashdata doctor --offline

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

  1. 401: verifique una clave caducada, revocada o configurada incorrectamente. 403: compare la fuente solicitada con los alcances de la identidad.
  2. 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.
Reemplazar y verificar una llave de propietario guardada
flashdata auth login --replace
flashdata auth status --json

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

Terminar y verificar
flashdata auth finish --wait --timeout 10m
flashdata auth status --json

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

Consultar la cuenta gratis
flashdata account balance
flashdata account pricing --source google_search --request-count 1

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.

Capturar la respuesta · 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
)
Inspección de la capacidad de la cuenta
flashdata account limits

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

Validar sin una presentación pagada
flashdata query --input request.json --mode async --dry-run --json

Trabajo 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 errorSiguiente acción
pending / processingEspera en el mismo trabajo; no lo vuelvas a presentar.
completedBusque y guarde el resultado existente.
failedInspeccione job.error antes de enviar el trabajo corregido.
404Compruebe el trabajo ID y la cuenta de envío.
409Los resultados no están listos. Sigue encuestando el mismo trabajo.
410JSON almacenado caducó después de las horas 24. Utilice su copia guardada; los medios entregados tiene su propia retención de almacenamiento.
Inspeccione el trabajo guardado · 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
)
Todavía funcionando · uso de la JOB_ID
flashdata jobs wait JOB_ID
Completado · utilizar un nuevo nombre de archivo de salida
flashdata jobs result JOB_ID --output recovered-result.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.

Inspección primero · reemplazar RUN_ID
flashdata runs show RUN_ID
Recuperar el trabajo confirmado
flashdata runs recover RUN_ID

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

Inspeccione la carrera original
flashdata runs show RUN_ID

Bú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.

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

Configuración de comprobación
codex mcp list
Sólo cuando se requiere el login OAuth
codex mcp login flashdata --scopes mcp:research

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

Compruebe el paquete de habilidad CLI predeterminado
flashdata skills verify --agent codex

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

Capturar un cheque de acceso gratuito CLI · Bash
flashdata auth status --json 2> diagnostic.json
Identificadores de error de Extracto · 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
Informe de apoyo
Hora 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: