SuperAPI AI 工具集

seedance2

编程与开发

查看项目

更新于 10-15 21:41

技能介绍

用途:通过火山引擎方舟(Volcengine Ark)API 创建 Seedance 2.0 异步视频任务、查询状态、等待终态并下载成片,需使用内置 shell 脚本而非自行拼装请求。

调用方式:将 {baseDir} 解析为包含 SKILL.md 的目录后执行:bash {baseDir}/scripts/seedance.sh <create|status|wait> [options]。依赖 Bash、curl、Python 3 以及环境变量 ARK_API_KEY,禁止打印密钥或将其直接写入命令行;仅允许用 HTTPS 覆盖 ARK_API_BASE_URL,默认 https://ark.cn-beijing.volces.com/api/v3。

主要能力与模式:文生视频(仅提示词);图生视频(提示词加 1 或 2 个公开图片 URL,第一张作 first_frame,第二张作 last_frame);参考生视频(提示词加至少一个公开图片或视频 URL,音频不能作为唯一参考)。仅支持公开 http:// 或 https:// 媒体 URL,API 不接收本地上传,只有本地文件时需向用户索取已托管 URL。

工作流:创建计费任务前先确认提示词与生成模式;模型、时长、媒体或输出不明确时应先确认而非试跑。常规流程用 create --wait,轮询固定每 10 秒一次,需要本地文件时加 --download-dir。已有任务可用 status 单次读取,或用 wait 固定 10 秒轮询。返回任务 ID、终态、token 用量及下载路径或 content.video_url,任务仍在排队或运行中时不得谎报完成。

限制与护栏:每次 create 均计费,超时、传输错误或异常响应后不得自动重提;模型限于 seedance-2-0、seedance-2-0-fast、seedance-2-0-mini 或官方 Ark 模型 ID;时长 4-15 秒,seed 取 -1 或 0-4294967295,宽高比与分辨率须为文档所列;参考生视频最多 9 图、3 视频、3 音频、共 12 个资源,视频与音频参考各自有 15 秒合计时长限制且 CLI 无法检测远程时长;不得传 callback_url,仅用轮询且不可配置间隔;Ark 结果 URL 24 小时后失效,应尽快下载;429 需遵守 Retry-After,失败任务上报 error.code 与 error.message,未经用户同意不得重试,保留并按要求汇总 API 响应 JSON。错误处理与字段细节见 references/api.md,来源契约为火山引擎方舟视频生成官方文档。