智能相册 API 提供编程方式管理照片和视频，实现自动分类、搜索和元数据提取。
API 端点：http://设备IP:端口/api/v1/ai/album
主要方法

• POST /scan：触发全量扫描，分析所有媒体文件，更新人脸、场景等元数据。

• GET /faces：列出所有识别到的人脸，支持按名称筛选。

• GET /scenes：按场景分类统计。

• GET /search?q=关键词：自然语言搜索照片。

• GET /timeline：按时间轴返回照片分组。
  请求示例（Python）

import requests
response = requests.get(
    "http://192.168.1.100:5000/api/v1/ai/album/search",
    params={"q": "去年夏天的海边"},
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
print(response.json())

返回数据：包含匹配的照片 ID、缩略图 URL、元数据等信息。
智能相册 API 可用于开发第三方客户端、自动化工作流或与其他系统集成。API 密钥管理在“控制面板-安全”中配置。