运行时依赖
安装命令
点击复制本土化适配说明
Maxhub Sora2 安装说明: 安装命令:["openclaw skills install maxhub-sora2"]
技能文档
🤖 Sora2(Sora2)Skill 你是Sora2平台的数据专家。你精通Sora2平台所有API的能力和限制,能根据用户需求智能选择最合适的API,必要时链式调用多个API完成复杂任务。
认证方式 / Authentication Method 所有API请求通过MaxHub API中转站调用,需在请求头中携带API Key: x-api-key: ${MAXHUB_API_KEY} 基础URL:${MAXHUB_BASE_URL}(默认 https://www.aconfig.cn)
API能力全景 / API Capabilities Overview 本Skill掌握Sora2 17个API,覆盖6大能力域: 能力域 API数量 核心能力 2 数据采集 8 获取作品的 Remix 列表/Fetch、获取用户发布的帖子列表/Fetch us、获取用户信息档案/Fetch user 内容解析 1 获取无水印视频下载信息/Fetch no 互动操作 4 获取用户粉丝列表/Fetch user 、获取作品一级评论/Fetch post 、获取用户关注列表/Fetch user 创作者/达人 1 获取 Cameo 出镜秀达人排行榜/Fe 搜索查询 1 搜索用户/Search users 工具服务 2 [已弃用/Deprecated] 文本/、[已弃用/Deprecated] 获取任
🚀 快速开始 / Quick Start 首次使用 / First Time Use 如果您是第一次使用本 Skill,请先完成以下步骤: 访问 MaxHub 官网 注册账号 在控制台创建 API Key 将 API Key 配置到环境变量 MAXHUB_API_KEY 中
API 调用格式 / API Call Format 所有 API 请求直接使用原始接口路径,无需额外前缀: # 基本调用格式 curl -X GET "${MAXHUB_BASE_URL}/api/v1/{platform}/web/fetch_data" \ -H "x-api-key: $MAXHUB_API_KEY"
认证说明 / Authentication Instructions 所有 API 请求需在请求头中携带 API Key: 请求头:x-api-key: $MAXHUB_API_KEY 在 MaxHub 官网 注册并获取 API Key
🔒 安全声明 / Security Statement 本Skill 仅 通过MaxHub API获取公开数据 / This Skill only fetches public data via MaxHub API,不访问用户本地文件系统 API Key 通过环境变量 / API Key is passed via environment variable MAXHUB_API_KEY 安全传递,不会 被存储、记录或转发到第三方 所有API请求均通过HTTPS加密传输 / All API requests are encrypted via HTTPS 本Skill 不会 读取浏览器Cookie / This Skill will not read browser cookies、SSH密钥、AWS凭证等敏感信息 本Skill 不会 修改任何系统配置文件 / This Skill will not modify any system configuration files
智能调度规则 / Intelligent Scheduling Rules
- 意图识别 → API选择 / Intent Recognition → API Selection
- 链式调用策略 / Chain Call Strategy
- 参数智能填充 / Intelligent Parameter Filling
⚡ 调用限制 / Rate Limits 为保护用户账户安全和控制费用,本Skill遵循以下限制: 限制项 / Limit Item 默认值 / Default 说明 / Description 单次最大翻页数 / Max Pages 5页 / pages 防止意外大量调用 单次最大返回条数 / Max Results 50条 / items 控制数据量 链式调用最大深度 / Max Chain Depth 3层 / layers 防止无限递归 批量操作最大数量 / Max Batch Size 10条 / items 控制批量大小 费用提醒阈值 / Cost Alert Threshold 连续调用超过20次时提醒 避免意外消耗余额
重要规则 / Important Rules: 每次调用前检查账户余额是否充足 / Check account balance before each call 翻页超过5页时必须提醒用户并确认 / Must remind and confirm with user when pagination exceeds 5 pages 批量操作前必须告知用户预计调用次数和费用 / Must inform user of estimated calls and costs before batch operations 不自动执行可能产生大量费用的操作 / Will not automatically execute operations that may incur high costs
API详细目录 / API Detailed Catalog 数据采集 获取单一作品详情/Fetch single post detail GET /api/v1/sora2/get_post_detail 获取作品的 Remix 列表/Fetch post remix list GET /api/v1/sora2/get_post_remix_list 获取用户信息档案/Fetch user profile GET /api/v1/sora2/get_user_profile(必填: user_id) 获取用户发布的帖子列表/Fetch user posts GET /api/v1/sora2/get_user_posts(必填: user_id) 获取用户Cameo出镜秀列表/Fetch user cameo appearances GET /api/v1/sora2/get_user_cameo_appearances(必填: user_id) 获取Feed流(热门/推荐视频)/Fetch feed GET /api/v1/sora2/get_feed 上传图片获取media_id/Upload image to get media_id POST /api/v1/sora2/upload_image [已弃用/Deprecated] 查询任务状态/Get task status GET /api/v1/sora2/get_task_status(必填: task_id)
内容解析 获取无水印视频下载信息/Fetch none watermark video download info GET /api/v1/sora2/get_video_download_info
互动操作 获取作品一级评论/Fetch post comments GET /api/v1/sora2/get_post_comments(必填: post_id) 获取评论的回复/Fetch comment replies GET /api/v1/sora2/get_comment_replies(必填: comment_id) 获取用户粉丝列表/Fetch user followers GET /api/v1/sora2/get_user_followers(必填: user_id) 获取用户关注列表/Fetch user following GET /api/v1/sora2/get_user_following(必填: user_id)
创作者/达人 获取 Cameo 出镜秀达人排行榜/Fetch Cameo leaderboard GET /api/v1/sora2/get_cameo_leaderboard
搜索查询 搜索用户/Search users GET /api/v1/sora2/search_users(必填: username)
工具服务 [已弃用/Deprecated] 文本/图片生成视频/Create video from text or image POST /api/v1/sora2/create_video [已弃用/Deprecated] 获取任务生成的作品详情(无水印版本)/Get task-generated post detail (watermark-free) GET /api/v1/sora2/get_task_detail
调用示例 / API Call Examples 基础调用 / Basic Call curl -X GET "${MAXHUB_BASE_URL}/api/v1/douyin/web/fetch_hot_search_result" \ -H "x-api-key: $MAXHUB_API_KEY" \ -H "Content-Type: application/json"
带参数调用 / Call with Parameters curl -X GET "${MAXHUB_BASE_URL}/api/v1/douyin/web/fetch_one_video?aweme_id=123456" \ -H "x-api-key: $MAXHUB_API_KEY"
POST请求 / POST Request curl -X POST "${MAXHUB_BASE_URL}/api/v1/douyin/web/fetch_user_like_videos" \ -H "x-api-key: $MAXHUB_API_KEY" \ -H "