Idioma: EspañolFilePulse Local HTTP API
Permite que la IA, los scripts, los lanzadores y las herramientas internas invoquen las capacidades de búsqueda y vista previa de FilePulse a través de la HTTP API local que utiliza la interfaz web FilePulse. Encuentra la misma grabación en archivos de audio y vídeo mediante el sonido y localiza sus posiciones.
http://127.0.0.1:80El ejemplo utiliza el puerto 80 HTTP predeterminado en config_default.json. Durante la implementación real, consulte el puerto en el archivo config.json local del usuario.
Comenzar aquí
Primero explore, luego inicie sesión para obtener el token y luego coloque el token devuelto directamente en el encabezado de Autorización. No agregue el prefijo Portador.
/api/verDevolver versión y plan. Las versiones en línea también pueden devolver uid y licencia_remaining_hours. Esta interfaz no requiere un token.
curl http://127.0.0.1:80/api/ver/api/loginEnviar nombre de usuario y contraseña usando JSON. La respuesta contiene nombre_servidor y token_acceso.
curl -X POST http://127.0.0.1:80/api/login \
-H "Content-Type: application/json" \
-d '{"username":"root","password":"root"}'Authorization: <access_token>Las solicitudes posteriores colocan directamente el token en el encabezado de Autorización o en el parámetro de consulta de Autorización.
curl http://127.0.0.1:80/api/search_scope_targets \
-H "Authorization: $FILEPULSE_TOKEN"Interfaces principales
Estas interfaces son las más adecuadas para flujos de trabajo asistidos por IA: descubra ámbitos, busque, obtenga una vista previa, descargue y abra archivos solo después de la confirmación del usuario.
/api/search_scope_targetsDevuelve objetivos de búsqueda indexados. Cuando necesite limitar el alcance de la búsqueda, coloque el índice de la unidad devuelta en drive_scope.
curl http://127.0.0.1:80/api/search_scope_targets \
-H "Authorization: $FILEPULSE_TOKEN"/api/searchBúsqueda por metadatos de archivo/carpeta, compatible con comodines o patrones regulares, filtrado, clasificación y paginación.
curl -X POST 'http://127.0.0.1:80/api/search' \
-H 'Content-Type: application/json' \
-H "Authorization: $FILEPULSE_TOKEN" \
--data-raw '{
"search_content": "a",
"mode": "wildcard",
"case_sensitive": false,
"search_by": "name",
"sort_by": "modified",
"sort_asc": false,
"content_plugin": [""],
"kind": 0,
"pin_priority": false,
"use_groups": false,
"start": 0,
"end": 13,
"inline_icon": {
"size": 32
}
}'/api/content_searchBuscar texto de documentos, texto OCR y contenido indexado de procesadores de contenido configurados. Se recomienda activar el fragmento cuando la IA necesite acceder al contexto.
curl -X POST 'http://127.0.0.1:80/api/content_search' \
-H 'Content-Type: application/json' \
-H "Authorization: $FILEPULSE_TOKEN" \
--data-raw '{
"linear": false,
"search_content": "a",
"mode": "regular",
"fuzzy_distance": 2,
"score_top_k": 100,
"sort_by": "score",
"sort_asc": false,
"snippet": false,
"snippet_radius": 100,
"pin_priority": false,
"use_groups": false,
"start": 0,
"end": 13,
"inline_icon": {
"size": 32
}
}'/api/visual_statusDevuelve si la búsqueda visual está habilitada, el progreso de la indexación, la cantidad de archivos que se pueden buscar, la cantidad de líneas vectoriales y la disponibilidad de ffmpeg.
curl http://127.0.0.1:80/api/visual_status \
-H "Authorization: $FILEPULSE_TOKEN"/api/visual_searchUtilice datos de formularios de varias partes para enviar imágenes, capturas de pantalla, vídeos o FilePulse la ruta de consulta absoluta en el host.
curl -X POST 'http://127.0.0.1:80/api/visual_search' \
-H "Authorization: $FILEPULSE_TOKEN" \
-F 'file=@query.jpg' \
-F 'top_k=20' \
-F 'drive_indices=[0]' \
-F 'fast_mode=true'/api/audio_statusConsulta la disponibilidad, el número de archivos para buscar, el progreso de indexación y FFmpeg.
curl http://127.0.0.1:80/api/audio_status \
-H "Authorization: $FILEPULSE_TOKEN"/api/audio_searchEnvía audio o vídeo con multipart form data para encontrar la misma grabación y sus posiciones. Usa la autenticación Authorization Token existente.
curl -X POST http://127.0.0.1:80/api/audio_search \
-H "Authorization: $FILEPULSE_TOKEN" \
-F "file=@query.mp3" \
-F "query_start_ms=10000" \
-F "query_end_ms=25000" \
-F "top_k=20"curl -X POST http://127.0.0.1:80/api/audio_search \
-H "Authorization: $FILEPULSE_TOKEN" \
-F "query_path=D:/media/query.mp3" \
-F "drive_indices=[0]" \
-F "top_k=20"total es el número total de archivos coincidentes. data puede contener varias posiciones de un archivo; top_k limita archivos, no posiciones. Los tiempos se expresan en milisegundos y los identificadores distinguen las pistas. Revisa warnings para búsquedas incompletas. Los errores HTTP contienen error.
{
"total": 1,
"data": [
{
"server_name": "local",
"name": "recording.mp4",
"full_path": "D:/media/recording.mp4",
"media_kind": "video",
"query_stream_index": 0,
"target_stream_index": 1,
"query_start_ms": 10000,
"query_end_ms": 25000,
"target_start_ms": 65000,
"target_end_ms": 80000
}
],
"warnings": []
}/api/download/{encodedPath}La transmisión devuelve rutas de archivos nativas o proxy. Introduzca la ruta completa en la ruta después de codificar y llevar la autorización URL. El servicio de archivos subyacente admite solicitudes de rango.
curl 'http://127.0.0.1:80/api/download/D%3A%5Cdocs%5Creport.pdf' \
-H "Authorization: $FILEPULSE_TOKEN" \
--output report.pdf/api/folder_previewDevuelve una lista pequeña y ordenada de carpetas para evitar extraer todas las carpetas secundarias a la vez.
curl -X POST http://127.0.0.1:80/api/folder_preview \
-H "Content-Type: application/json" \
-H "Authorization: $FILEPULSE_TOKEN" \
-d '{"path":"D:\\docs","limit":50}'/api/content_match_previewObtener contexto HTML/texto para un determinado resultado de búsqueda de contenido, de modo que AI pueda verificar la ubicación del acceso antes de solicitar abrir el archivo.
curl -X POST http://127.0.0.1:80/api/content_match_preview \
-H "Content-Type: application/json" \
-H "Authorization: $FILEPULSE_TOKEN" \
-d '{
"path": "D:\\docs\\report.pdf",
"modified": 1717113600,
"search_content": "invoice",
"mode": "regular",
"linear": false,
"fuzzy_distance": 2
}'/api/openfileInicie el archivo o programa ejecutable en la máquina donde se encuentra FilePulse. Esta operación tiene efectos secundarios y las herramientas de inteligencia artificial deberían pedir a los usuarios que primero la confirmen explícitamente.
curl -X POST http://127.0.0.1:80/api/openfile \
-H "Content-Type: application/json" \
-H "Authorization: $FILEPULSE_TOKEN" \
-d '{"path":"D:\\docs\\report.pdf","work_folder":"","admin":false}'/api/quick_launcherBusque aplicaciones, carpetas y accesos directos iniciables, y el cuerpo de la solicitud básicamente sigue la estructura de /api/search.
curl -X POST http://127.0.0.1:80/api/quick_launcher \
-H "Content-Type: application/json" \
-H "Authorization: $FILEPULSE_TOKEN" \
-d '{
"search_content": "chrome",
"mode": "wildcard",
"case_sensitive": false,
"search_by": "full_path",
"sort_by": "modified",
"sort_asc": false,
"content_plugin": [""],
"kind": 0,
"start": 0,
"end": 9
}'Recomendaciones de llamadas de IA
Mantenga el modelo en un camino estrecho: autentique, busque, inspeccione y luego solicite la confirmación del usuario antes de abrir o cambiar el archivo.
Se recomienda que el usuario o el programa anfitrión proporcione un token de sesión breve. No guarde contraseñas en la memoria del modelo, registros largos ni palabras de aviso reutilizables.
Abrir un archivo puede iniciar un programa o exponer datos locales. La IA debería mostrar la ruta exacta y esperar la aprobación del usuario.
Se recomienda utilizar el extremo 9 o el extremo 19 primero, verificar el nombre del archivo y el resumen, y luego solicitar más resultados según sea necesario.
Esta página no cubre
Las siguientes interfaces no se incluyen intencionalmente en la página de entrada pública, porque pertenecen a comunicación interna, operaciones destructivas, interfaces de administración o son más adecuadas para escribir documentos avanzados por separado.