SuperAPI AI 工具集

sora

编程与开发

查看项目

更新于 10-15 21:42

技能介绍

用途:为当前项目创建或管理短视频片段,如产品演示、营销短片、电影感镜头、UI 模拟。默认使用 sora-2 模型和结构化提示词增强流程,优先使用内置 CLI 以保证可复现运行。注意:$sora 是提示词中的技能标签,不是 shell 命令。

主要能力:根据提示词生成新视频;按 ID 混剪已有视频;轮询状态、列出任务、下载素材(视频/缩略图/精灵图);批量运行多个提示词或变体。决策逻辑:有视频 ID 且要修改则混剪;有 ID 且要状态或素材则查询/下载;需要多个提示词或素材则批量创建;需要同一镜头的小改动两版则先创建基础版再混剪变体;否则创建,或一步创建并轮询。

使用方式:先确定意图,收集提示词、模型、尺寸、秒数和参考图。批量时在 tmp/ 下写临时 JSONL(每行一个任务),运行一次后删除。优先使用 CLI 增强标志(--use-case、--scene、--camera 等),若已有结构化提示词文件则加 --no-augment 避免重复包装。长提示词用 --prompt-file 避免转义问题。异步任务需轮询至完成,或使用 create-and-poll。下载素材并保存本地,清理中间文件。认证:必须设置 OPENAI_API_KEY,缺失时引导用户在 https://platform.openai.com/api-keys 创建并本地设置,切勿让用户在聊天中粘贴完整密钥。

默认与规则:默认模型 sora-2(sora-2-pro 更高保真);默认尺寸 1280x720;默认 4 秒(允许 "4"、"8"、"12" 字符串)。尺寸和秒数必须通过 API 参数设置。使用 OpenAI Python SDK,不用原始 HTTP。参考图须为 jpg/png/webp 且匹配目标尺寸。下载 URL 约 1 小时后过期,需转存自有存储。不要修改 scripts/sora.py,除非用户要求。

限制:模型仅限 sora-2 和 sora-2-pro;API 访问需组织验证账户;时长限 4/8/12 秒且以字符串枚举传入;输出尺寸受模型限制;视频创建为异步,须轮询后下载;速率限制按使用层级;内容限制由 API 执行。护栏:仅限适合 18 岁以下受众的内容;禁止版权角色或音乐;禁止真实人物(含公众人物);含人脸的输入图会被拒绝。提示词增强仅将隐含细节显式化,不编造新创意要求。