用途:HyperGen Agent 用于 HyperGen 创作者代理工作流,包括加载托管代理文档、检查积分、生成图片/视频、轮询任务、使用图片参考,以及创建 Postiz 草稿。
主要能力:通过 API 生成模型图、产品图与视频;上传用户媒体;轮询任务状态;创建 Postiz 草稿或从任务生成完整帖子包;配置“员工模式”自动化(draft/schedule/publish);执行 Instagram、TikTok、YouTube 社交互动;记录代理事件与运行状态。
使用方式:先运行 scripts/check_updates.sh 做更新预检。API 基址默认 https://api.hypercho.com,外部代理路由始终包含 /skill/hypergen,使用 Authorization: Bearer $HYPERGEN_API_KEY。建议将密钥存入 $HOME/.hypergen/credentials.env 并设置权限 600。常用端点包括 catalog、credits、models/:modelId、generate、video、uploads、jobs/:id、postiz/drafts、agent-automations、agent-permissions、agent-events、agent-runner-status。生成前需按决策树选择正确请求体,例如模型单图用 intent: "model-image",产品图用 intent: "product-image",视频用 /video。Postiz 草稿需先轮询任务至 completed,再调用 /postiz/drafts,优先使用 jobIds。
适用场景:需要批量生成 HyperGen 图片/视频并发布到社交渠道的创作者;需要每日自动发帖的“员工模式”;需要跨平台社交互动自动化的代理。
限制:密钥具有模型/产品范围限制,403 SCOPE_MISMATCH 表示范围不匹配而非密钥无效。权限分两层:HyperGen 服务端策略与本地浏览器/社交账号访问,后者需本地运行器验证。付费生成前需展示请求体并确认积分成本。不得在文件中存储原始 API 密钥,不得用 set -x 运行脚本,不得用 python -m json 解析拼接输出。社交互动需权限检查返回 allowed: true 才可执行。具体价格、平台支持细节与效果暂未提供。