CLI 与 MCP

版本 0.2.2 · 使用本站 API Key。项目、参考素材和下载的结果保存在你的电脑。

需要 Node.js 22 或以上。本机目录项目不与网页画布实时同步。

安装与初始化

在下载目录打开 PowerShell：

npm install --global --ignore-scripts ./uutoken-project-cli-0.2.2.tgz
uutoken init D:/my-video-project --url https://uutoken.sbs

从控制台复制你自己的本站 Key，在同一 PowerShell 窗口运行下列命令后隐藏输入。不要把 Key 写入提示词或项目文件。

$uutokenKey = Read-Host '请输入本站 Key' -AsSecureString
$uutokenKeyPointer = [IntPtr]::Zero
try {
    $uutokenKeyPointer = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($uutokenKey)
    $env:UUTOKEN_API_KEY = [Runtime.InteropServices.Marshal]::PtrToStringBSTR($uutokenKeyPointer)
} finally {
    if ($uutokenKeyPointer -ne [IntPtr]::Zero) {
        [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($uutokenKeyPointer)
    }
    $uutokenKey.Dispose()
    Remove-Variable uutokenKey, uutokenKeyPointer
}

选模型与预检

uutoken model list --type video --project D:/my-video-project
uutoken model find Seedance --type video --project D:/my-video-project --json
uutoken text2video --id shot-01 --model sd2.5-gf-720p --prompt "镜头缓慢推进" --duration 5 --project D:/my-video-project --dry-run

--dry-run 只预检参数并联网读取目录，不上传素材、不提交生成。模型名与分组 ID 以实时目录为准；指定分组加 --group '<分组ID>'。专属价格和积分结算继续由本站处理。

生成与取回

以下生成命令会扣费。确认模型、分组与价格后再运行。

uutoken text2video --id shot-01 --model sd2.5-gf-720p --prompt "镜头缓慢推进" --duration 5 --project D:/my-video-project --poll 900 --download

图生视频先把图片放进项目 references/hero.png，再预检：

uutoken image2video --id shot-02 --model sd2.5-gf-720p --prompt "保持角色一致" --duration 5 --image references/hero.png --project D:/my-video-project --dry-run

确认后将 --dry-run 换成 --poll 900 --download。参考文件无效或协议不支持时会停止，不会静默丢图改成文生视频。

uutoken list_task --project D:/my-video-project
uutoken query_result --submit_id '<当前项目已记录的远程任务ID>' --project D:/my-video-project --poll 900 --download_dir outputs
uutoken assets --project D:/my-video-project --json

查询和下载不会重新生成。提交结果不明时先核对任务记录，不要换 ID 再次付费提交。

接入 Agent

uutoken mcp --project D:/my-video-project

提供 stdio MCP，不监听网络端口。API Key 由进程环境继承；付费工具需显式 confirmBillable:true。脚本调用加 --json，参数以 uutoken --help 和 uutoken schema --json 为准。

使用结束

Remove-Item Env:UUTOKEN_API_KEY -ErrorAction SilentlyContinue

隐藏输入可避免把 Key 直接写入命令历史；进程环境仍是内存中的明文，不能对本机管理员或同权限进程保密。