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。