sora2listed
Install: claude install-skill XieWxx/maxhub-api-skills
> ⛔ **合规硬前置指令(HARD PREREQUISITE — Agent 不得跳过)**
>
> 在执行任何 API 调用、读取 reference 文件、匹配 recipe 之前,Agent **必须**先完成 §基础使用 Step 0 的合规检查。
>
> - **禁止**绕过 Step 0 直接进入 Step 1(检查 API Key)或更后续步骤
> - **禁止**以"用户已多次使用"为由跳过首次闸门或风险检测
> - **禁止**将 Step 0 的合规检查视为可选步骤
> - 若 Step 0 未通过(首次确认缺失、用户拒绝、风险检测未确认),**立即停止**,不执行任何后续操作
>
> 违反此指令将导致法律合规风险,Agent 必须严格执行。
# Sora2 数据助手
## 1. 简介
Sora2 内容创作与作品分析 skill,通过 MaxHub API 查询作品、用户、评论、回复、二创/Remix、下载/媒体信息,并支持上传图片、创建视频等创作相关写操作。适合 AI 视频创作工作流、作品复盘、二创传播分析和素材管理。属于 read_write skill;agent 对 create/upload/download 等非只读能力必须按 confirmation 规则确认,普通查询优先走 recipes 与字段流字典。所有请求发送到 https://www.aconfig.cn。
> **架构亮点**:本 Skill 采用三层结构 — **Atomic 原子层**(端点的标准化封装)+ **Recipe 编排层**(多步业务场景脚本)+ **Reference 详情层**(端点 5 区契约)。Agent 可按"目标 → recipes 匹配 → atoms 映射 → reference 详情"四步路径精准调用,杜绝臆造。
## 2. 详细功能
### 作品数据
- 查询 Sora2 作品的完整详情,包含作者信息、视频内容、点赞/评论/转发统计、Cameo 出镜信息等
- 支持通过作品 ID 或作品分享链接两种方式查询作品
- 拉取指定作品下的一级评论列表,支持翻页
- 拉取指定���论下的全部二级回复,构建完整评论树
- 查询某个作品的全部 Remix 二创列表,追踪内容传播链路
- 获取作品的无水印视频下载链接,下载受限时自动降级为带水印版本
- 拉取 Sora2 首页的推荐 Feed 流,识别近期热门作品
### 用户数据
- 按用户名搜索 Sora2 平台用户
- 查询指定用户的完整资料画像,包含昵称、头像、简介、粉丝数、作品数、Cameo 数等
- 拉取指定用户已发布的全部作品列表
- 查看指定用户的关注列表与粉丝列表
- 拉取指定用户的 Cameo 出镜记录,分析其在他人作品中的出镜表现
### AI 视频生成
- 上传图片素材,作为后续图生视频任务的输入
- 创建文生视频任务,根据文字 prompt 生成 Sora2 视频
- 创建图生视频任务,基于上传的图片素材生成 Sora2 视频
- 轮询查询视频生成任务的实时状态(排队中、生成中、已完成、失败)
- 获取视频生成任务完成后的最终视频 URL 与元信息
### 平台热榜
- 拉取 Sora2 全平台 Cameo 出镜热度榜单,识别平台明星用户与高频出镜内容
### 账号余额查询
- 查询 MaxHub API 账号剩余额度,支持 `x-api-key` 或 `Authorization: Bearer` 两种认证方式
- 频率限制:最快