Skill

任务结果

轮询 Freebeat MV、特效、图片和视频任务，并提取完成后的结果 URL。

freebeat CLI

立即使用已预置

社区总使用量

7积分使用量

9总生成次数

关于 Skill

skill.md

# 任务结果

当已经有 Freebeat task id 或 Open RPC batch id，并需要查状态、等待或获取结果 URL 时，使用这个 Skill。

## 执行 CLI 命令前

Freebeat CLI 是 npm 包，也是需要认证的 API 客户端。请先安装或更新：

~~~bash
npm install -g freebeat-cli@latest
freebeat --help
~~~

生成前必须提供 Freebeat API key。可以使用以下任一方式：

~~~bash
freebeat auth set-api-key
printf '%s' "$FREEBEAT_API_KEY" | freebeat auth set-api-key --stdin
freebeat --api-key <apiKey> <command>
~~~

开始付费或长时间工作流前，先验证凭证：

~~~bash
freebeat auth show
freebeat auth test
~~~

不要粘贴或记录原始 API key。请让用户在终端、secret store 或环境变量中提供。

## 旧版 MV 和特效任务

~~~bash
freebeat task status <task-id>
freebeat task wait <task-id>
freebeat task result <task-id>
~~~

## Open RPC 图片和视频批次

~~~bash
freebeat task status <batch-id>
freebeat task status <batch-id> --serial-no <serial-no>
freebeat task wait <batch-id> --serial-no <serial-no>
~~~

## JSON 输出

~~~bash
freebeat task status <batch-id> --serial-no <serial-no> --json
freebeat task result <task-id> --json
~~~

## 等待行为

默认轮询间隔是 15 秒，默认超时是 2 小时。较长队列或快速本地检查时可以覆盖：

~~~bash
freebeat task wait <task-id> --poll-interval 30s --timeout 3h
~~~

预期结果：任务运行中 CLI 会返回状态字段，完成后返回 video_url、cover_url 或 Open RPC 结果 URL。