Search (搜索服务)
aimage.search 模块提供对 AI-Mage Search API 的完整访问能力，是 AIMage SDK 中最核心的服务模块。
功能概览
| 功能 |
说明 |
| 项目管理 |
访问和遍历制作项目 |
| 视频与片段 |
获取视频信息、浏览所有片段（Clip）及其 AI 标签 |
| AI 搜索 |
文本搜索、多模态（文本 + 图像）搜索，支持丰富的过滤器 |
| 角色管理 |
查询、创建、更新和删除角色，管理图库、概念图、角色设定和材料绑定 |
| 资料管理 |
管理参考图像、其他材料、资源文件、漫画、小说和 OCR |
| 翻译表 |
管理多语言翻译表、列定义和条目 |
| Clip Metadata |
更新 Clip 标签、角色、字幕和自定义 metadata |
| Agent / Chatbot |
读取项目上下文、搜索 clips / novels、保存生成图、管理对话分支 |
| 资源下载 |
保存视频、片段、缩略图、参考图、漫画、小说和其他材料到本地 |
| 结构化数据 |
解析剧本（Script）和香盘表（Koubanhyou）数据 |
快速开始
from aimage import search
with search.client(token="your_token_here") as client:
for project in client.projects():
print(project.name)
# 文本搜索
for clip in project.search(query="夕焼け"):
print(f" [{clip.start_time:.1f}s - {clip.end_time:.1f}s] {clip.subtitle}")
数据模型关系
SearchClient
└── Project
├── Video[]
│ ├── Clip[] # 视频片段
│ ├── VideoResource[] # 附属资源（剧本、香盘表等）
│ ├── PredictCreator[] # 预测创作者
│ └── PredictCharacter[] # 预测角色
├── Character[] # 角色列表
├── ReferenceImage[] # 参考图片列表
├── Resource[] # 其他材料/资源
├── TranslationTable[] # 翻译表
├── Manga[] # 漫画列表
└── Novel[] # 小说列表
文档导航