技能介绍

要解决的问题

把一段文字描述变成可交付的视频，中间通常要经历选模型、调分辨率、提交任务、反复刷新状态、再手动下载等多步操作。本技能针对的是「文本到视频」这一链路中缺少统一调度入口的问题：工程师需要把 prompt 交给 Seedance 2.0 模型，还要处理任务排队、生成进度、失败重试和产物落盘，这些步骤如果各自手写会非常碎片化。

技能如何工作

技能基于 Seedance 2.0 模型，通过 tokease.com 的 API 创建视频生成任务，并提供项目内的 seedance.py 命令行工具，覆盖创建、查询、下载完整流程。

核心步骤如下：

获取凭证：在 tokease.com 注册账号，于 API Keys 页面创建 Key，并通过 SEEDANCE_API_KEY 环境变量注入。调用 API 前会先检查该变量是否已设置，未设置则无法发起请求。
创建任务：调用创建接口提交 prompt（视频画面描述）。默认模型为 Seedance 2.0/u3，可通过 --model 覆盖。
参数控制：支持画幅（16:9、4:3、1:1、3:4、9:16、21:9）、时长（秒）、分辨率（480p、720p、1080p）、--seed 随机种子（-1 为随机）、--negative-prompt 负向提示词。
查询与轮询：任务状态分为 pending（排队中）、running（生成中，含 progress 百分比）、completed（完成，视频 URL 位于 output.video_url）和 failed（失败）。默认轮询间隔为 15 秒，可用 --wait 在创建后自动等待完成。
下载产物：生成完成后立即下载视频，可用 --download 指定目录，例如 ~/Desktop。

技能同时支持用 curl 直接调用创建与查询接口，便于在脚本或流水线中嵌入。若通过 AI 助手（如 WorkBuddy）使用，直接描述想要的画面即可，助手会自动调用此技能。

适用边界与注意点

生成耗时较长：视频生成可能需要数分钟，建议使用 --wait 自动等待，避免频繁手动查询。
产物 URL 有时效性：output.video_url 不是长期存储地址，生成后应尽快下载，否则链接可能失效。
错误处理：任务失败时会清晰展示错误信息，并提示可能的修复方案；排查问题时可先确认 API Key 是否有效、网络是否可达。
任务可追溯：调用过程始终告知用户任务 ID，便于后续查询与管理。
依赖外部服务：本技能本身不含模型推理能力，实际生成质量取决于 Seedance 2.0 模型与 tokease.com 服务，网络或服务端异常都会直接影响结果。