核心用法
MaxHub Sora2 Skill 是面向 OpenAI Sora2 平台的综合数据与创作工具，通过 MaxHub API（https://www.aconfig.cn）提供 17 个标准化端点，覆盖三大能力域：
1. 作品数据查询：支持作品详情、评论回复树、Remix 二创链路、无水印下载、首页 Feed 推荐等完整分析能力。用户可通过作品 ID 或分享链接快速获取点赞/评论/转发统计、Cameo 出镜信息及传播图谱。
2. 用户画像分析：提供用户名搜索、完整资料画像、作品列表、关注/粉丝关系、Cameo 出镜记录等维度，帮助识别平台 KOL 与高频出镜内容创作者。
3. AI 视频生成：支持图片上传、文生视频、图生视频任务创建，以及异步任务状态轮询与结果获取，适配批量内容生产工作流。
显著优点
- 三层架构设计：Atomic 原子层（标准化端点）+ Recipe 编排层（预置业务脚本）+ Reference 详情层（5 区契约），Agent 可按"目标→recipes→atoms→reference"精准调用，杜绝臆造路径与参数
- 防臆造四道闸：路径白名单硬校验（YAML）+ 强标记（Full path）+ 禁止规则 + 错误反馈机制，确保调用安全
- 链式调用图谱：内置字段流字典与 14+ 预置 Recipe，支持作品→评论→回复、用户名→用户主页→作品列表、视频生成→轮询→结果获取等多步链路
- 风险分级处理：按 low/medium/high/critical 四级风险简化调用前自检，low 风险端点仅需白名单校验，提升效率
- 异步任务最佳实践：内置轮询间隔、状态语义、超时封顶等规范，支持子会话专职轮询
潜在缺点与局限性
- 第三方数据依赖：所有请求发送至
https://www.aconfig.cn，数据实时性与服务稳定性受 MaxHub API 制约 - 凭证管理负担：需妥善保管
MAXHUB_API_KEY，建议使用独立测试账号并定期轮换，存在密钥泄露风险 - 写入操作需确认：
create_video、upload_image等写入接口必须用户显式确认参数，增加交互步骤 - UGC 隐私合规：拉取的评论/用户信息可能含敏感内容，使用方需自行确保符合《个人信息保护法》/GDPR/平台 ToS
- 轮询成本：异步视频生成任务需持续轮询，长耗时场景可能占用会话资源
适合人群
- Sora2 内容创作者：寻找爆款规律、分析 Remix 传播链、批量生成 AI 视频
- AI 视频研究者：采集 Cameo 数据、构建传播图谱、进行平台生态分析
- 社媒分析师：追踪内容传播链路、识别 KOL 二创节点、绘制影响力图谱
- 自媒体运营团队：批量视频生产、多账号矩阵分发、异步任务管理
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 凭证泄露 | API Key 写入日志或对话 | 敏感标记 + 环境变量隔离 |
| 第三方服务中断 | MaxHub API 不可用 | 端点替换矩阵 + 降级策略 |
| 数据合规 | UGC 含个人信息 | 独立测试账号 + 最小化采集 + 授权处理 |
| 写入误操作 | 重复扣配额或错误生成 | 用户确认机制 + 幂等性设计 |
| 轮询阻塞 | 异步任务长时间占用会话 | 子会话轮询 + 10 分钟封顶 |