用途：按文本查询检索网络视频，返回排序后的视频结果，并给出视频内最相关片段的起止时间戳，方便直接跳转到对应时刻。
主要能力：结果包含标题、视频 URL、来源页、描述、封面图、总时长（秒）、匹配片段（start_seconds/end_seconds）、频道或作者、发布时间与最近抓取时间；响应还带 request_id、meta.latency 与可能的 meta.warning。支持按相对时间窗口（day/week/month/year 或 d/w/m/y）及 ISO 8601 的 start_time、end_time 过滤，safesearch 可选 off 或 strict（默认 strict）。
使用方式：接口为 POST https://api.octen.ai/video-search，认证使用 X-Api-Key 请求头，Content-Type 为 application/json。请求体示例：{"inputs":[{"type":"text","data":"how to tie a tie"}],"count":5}。inputs 为必填，仅支持一个文本输入，查询最长 500 字符；count 可选，默认 5，范围 1–10；time_range、start_time、end_time、safesearch 均可选。需先设置 OCTEN_API_KEY：Claude Code 在 ~/.claude/settings.json 添加 { "env": { "OCTEN_API_KEY": "your-key" } }；Cursor 或通用 shell 在 ~/.zshrc 或 ~/.bashrc 中 export OCTEN_API_KEY="your-key"；Codex 在 ~/.codex/config.toml 的 [shell_environment_policy] 设置 set = { OCTEN_API_KEY = "your-key" }；OpenClaw 在 ~/.openclaw/.env 添加 OCTEN_API_KEY=your-key。
适用场景：需要按主题或事件查找网络视频，并定位视频中相关片段时使用。
限制：目前处于邀请制 Beta，需通过 https://octen.ai 或 support@octen.ai 申请访问，无权限时调用会失败。缺少密钥或返回 401 时应停止并提示用户配置密钥，不要盲目重试；403 表示密钥有效但请求被拒，可能是无 Beta 权限或账户余额不足。输入目前仅支持文本。错误码包括 400、401、403、429、500。count 上限为 10。