用途:把一句创意逐步扩写为分镜,生成参考图,提交 Seedance 2.0 视频任务并轮询取回成片,实现从概念到最终视频的端到端流程。\n\n主要能力:先判断执行模式,读取 mcps/user-xskill-ai/STATUS.md 检查 MCP;可用则用 submit_task、get_task、upload_image、get_balance,不可用或报错则改用脚本模式。脚本路径为 .cursor/skills/seedance2-api/scripts/seedance_api.py,脚本模式需设置 XSKILL_API_KEY(export XSKILL_API_KEY=sk-your-api-key,密钥在 https://www.xskill.ai/#/v2/api-keys 获取)并安装 requests。可用 Seedream 4.5 文生图(fal-ai/bytedance/seedream/v4.5/text-to-image)与图像编辑(fal-ai/bytedance/seedream/v4.5/edit)生成角色、场景与首尾帧。视频模型为 st-ai/super-seed2,支持 omni_reference(默认,image_files 最多 9、video_files 最多 3、audio_files 最多 3)与 first_last_frames(filePaths 传 0/1/2 张图)两种模式,ratio 可选 21:9、16:9、4:3、1:1、3:4、9:16,duration 为 4–15 整数,model 可选 seedance_2.0_fast(默认)或 seedance_2.0。提示词用 @image_file_N、@video_file_N、@audio_file_N 引用素材。\n\n使用方式:脚本命令包括 submit --model MODEL --params '{...}'、query --task-id ID、poll --task-id ID --interval N --timeout N、balance、upload --image-url URL 或 --image-path PATH。图片约 1–2 分钟完成,建议 30 秒后首查再每 30 秒查询;视频约需 10 分钟,建议 60 秒后首查再每 90 秒查询,也可用 poll 自动轮询(视频 interval 30、timeout 600)。状态为 pending、processing、completed、failed,完成后取回 URL。\n\n限制:不支持上传真实人脸;文件总数上限 12(图片 9 + 视频 3 + 音频 3);视频与音频参考总时长不超过 15 秒;视频参考消耗更多额度。详细分镜模板与镜头术语见 reference.md。
seedance2-api
编程与开发
更新于 10-15 22:13